How to relocate the Confluence home directory

Still need help?

The Atlassian Community is here for you.

Ask the community

Purpose

There are times when the Confluence home directory might need to be relocated. For example, perhaps the disk containing that directory has run out of space.

Solution

 To relocate the home directory, follow the steps below:

Before proceeding, be sure to take note of the definition of Confluence Home and other important directories and Confluence Install Directory.

  1. Stop Confluence.
  2. Backup the Confluence home directory.
  3. Move the Confluence home directory to the new location.
  4. Edit the <confluence-install-directory>/confluence/WEB-INF/classes/confluence-init.properties file by changing the confluence.home property to point to the new location:

     confluence.home=/path/to/your/confluence/home

    Note for Windows Users

    Each backslash in your path must be written as a forward slash.

    For example, c:\confluence\data should be written as c:/confluence/data

    Note for Unix Users

    NOTE: If the path of your confluence.home directory contains symlinks, please set confluence.home to the absolute path, otherwise problems may occur.

    For example, where /data is a symlink to -> /var/data/

    confluence.home=/data/confluence/ should be written as confluence.home=/var/data/confluence

  5. Start Confluence



Last modified on Mar 21, 2024

Was this helpful?

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