Migrating Crowd Between Servers

This guide applies to situations when you may need to migrate Crowd to a new server, because:

  • Your Crowd server hardware is changing.
  • You are cloning your production server for a staging, test or development instance.


  1. Make sure you have a Crowd license for the new server you are targeting. Developer/staging licenses are available for any commercial or academic license. Create a developer license or contact us for help.
  2. Perform a file system backup of the Crowd Home and Crowd Installation directories.
  3. Perform a full database backup.

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


  1. Restore the file system and database backups on to the target server.
  2. Locate the shared/crowd-cfg.xml file in the target server's Crowd Home directory. Modify it to point to the new database, if the name/location of it has changed, in this property: <property name="hibernate.connection.url">
  3. Locate the crowd-init.properties file in your target server's Crowd Installation directory. Modify it to point to the new Crowd Home if the location of it has changed.

Post Migration Verification

  1. If your original server serves using HTTPS and the migrated server is on HTTP, you would need to turn off secure cookie with the following SQL query :

  2. 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

  1. 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 the URL is different from the original server's URL.
  2. If you have installed any Crowd plugins or added other customizations, you will need to re-apply them on the new server.

If you encounter any difficulties, please feel free to contact support and let us know which step you are having problems with.

Last modified on Oct 15, 2021

Was this helpful?

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