How to relocate the Confluence home directory
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.
To relocate the home directory, follow the steps below:
- Stop Confluence.
- Backup the Confluence home directory.
- Move the Confluence home directory to the new location.
<confluence-install-directory>/confluence/WEB-INF/classes/confluence-init.propertiesfile by changing the confluence.home property to point to the new location:
Note for Windows Users
Each backslash in your path must be written as a forward slash.
c:\confluence\datashould be written as
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
/datais a symlink to ->
confluence.home=/data/confluence/should be written as
- Start Confluence