Migrate to Another Database

This guide applies to situations when you may need to migrate Crowd to another database.

Before you begin

  • Select a new database from one of our Supported Platforms
  • Perform an XML backup of your existing Crowd server. Make sure that you check the 'Reset Domain' checkbox, otherwise you may be prevented from logging in to the new Crowd Administration Console.
  • If you are also migrating the instance to a new server, please also refer to Migrating Crowd Between Servers

(info) From this point on, we will call your existing Crowd server the 'original' server.


  1. Copy the XML backup over to the target server. 
  2. Install Crowd on the target server using our installation guide.
    • The Crowd version can be the same or higher than the version on the original Crowd server.
    • When specifying your Crowd Home directory, make sure you choose a new location and not your original Crowd Home directory. 
  3. Run the Setup Wizard.
    • When asked for the type of installation, choose 'Import data from an XML backup'. Provide the full path to your XML backup file and import the data.
    • When given the option of configuring Crowd to target a database, make sure you choose a new one and not your original Crowd database. 
  4. When the import finishes, shut down Crowd. 

Post Migration Verification

  1. Start Crowd on the new server. You should be able to authenticate and access Crowd using the same credentials as on your original Crowd server.

Applications and Customizations

For any application you are going to test against this new Crowd server, you will need to modify the application's crowd.properties file to point to this new server. 

If you have installed any Crowd plugins or added other customizations, you will need to re-apply them on the new server.

Last modified on Oct 15, 2021

Was this helpful?

Provide feedback about this article
Powered by Confluence and Scroll Viewport.