Migrating Confluence Between Servers
This page describes how to move Confluence between physical servers using the same or a different operating system.
On this page:
Transferring Confluence to another server
To transfer Confluence to another server you will copy the home and install folders straight into an identical external database and user management setup. If your new server is using a different operating system there may be some additional changes at step 4.
- Run the Confluence installer on your new server
- Shut down Confluence on both your old and new servers
- If you're using Oracle or MySQL, copy the drivers from your old server to the new one
Delete the contents of the home directory on your new Confluence server, then copy in the contents of the home directory from your old Confluence server.
Make any additional changes required for your environment.If you're changing the location of the home directory...
If the path to your home directory is different on the new server open the
Confluence_install_directory/confluence/WEB-INF/classesdirectory and edit
confluence-init.propertiesby changing the line starting with '
confluence.home='.If you're moving your database...
If you have also moved your database from one server to another you can change the JDBC URL in
<confluence.home>/confluence.cfg.xmlif you are using a direct JDBC connection or in the definition of your datasource (if you are connecting via a datasource).If your new server has a different operating system...
If you're migrating from Windows to Linux, you'll need to replace the backslashes with forward slashes in the following lines in
If you're migrating from Linux to Windows, you'll need to replace the forward slashes with backslashes in the following lines in
<confluence-install>/conf/server.xmlfile from your old server to the same location on your new server
- If you use a data source, follow the instructions for your database type and ensure the data source points to the new database: PostgreSQL, MySQL, SQL Server or Oracle.
- Start Confluence, then head to General configuration > License Details to add your license key
We strongly recommend you perform a rebuild of your content indices after performing a migration, to ensure Confluence search works as expected.
Was this helpful?
Thanks for your feedback!