How to relocate the Confluence home directory
Platform Notice: Data Center - This article applies to Atlassian products on the Data Center platform.
Note that this knowledge base article was created for the Data Center version of the product. Data Center knowledge base articles for non-Data Center-specific features may also work for Server versions of the product, however they have not been tested. Support for Server* products ended on February 15th 2024. If you are running a Server product, you can visit the Atlassian Server end of support announcement to review your migration options.
*Except Fisheye and Crucible
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.
- Stop Confluence.
- Backup the Confluence home directory.
- Move the Confluence home directory to the new location.
Edit the
<confluence-install-directory>/confluence/WEB-INF/classes/confluence-init.propertiesfile by changing the confluence.home property to point to the new location:confluence.home=/path/to/your/confluence/homeNote for Windows Users
Each backslash in your path must be written as a forward slash.
For example,
c:\confluence\datashould be written asc:/confluence/dataNote 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
/datais a symlink to ->/var/data/confluence.home=/data/confluence/should be written asconfluence.home=/var/data/confluence- Start Confluence