Looking for the latest version of this document? See Migrating Confluence between servers.

 

This page tells you how to copy a Confluence instance from one server to another. For example, you may want to transfer your current production snapshot to a test server as permitted in the licence agreement.

Take these steps on the original server:

  1. Stop Confluence.
  2. Make a copy of your Confluence installation directory.
  3. Make a copy of your Confluence home directory.
  4. Use your database administration tool to access your external database and create a Confluence database export.
  5. Start Confluence.

Take these steps on the target server:

  1. If you have Standalone Confluence and wish to use it on the target server then you can drop in the installation directory. Otherwise, you will need to follow our Confluence Installation Guide and set up the new installation. Make sure to use the same Confluence and application server versions.
  2. Set up the database to be an exact clone of the original:
    1. Set up the same database version and driver.
    2. Set up the database user to have the same permissions as the original.
    3. Import the Confluence database export.
  3. Place the copy of your Confluence home directory onto the target server.
  4. If the home directory is in a different location, go to the Confluence installation directory and edit ..\confluence\WEB-INF\classes\confluence-init.properties. The home directory is set under confluence.home.
  5. To modify any database connection information, go to the Confluence home directory and edit confluence.cfg.xml. The connection URL is set under hibernate.connection.url.
  6. Start Confluence.

The target instance will be a clone of the original instance.

RELATED TOPICS

Except where otherwise noted, content in this space is licensed under a Creative Commons Attribution 2.5 Australia License.