How to relocate the Confluence home directory
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.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 asc:/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 asconfluence.home=/var/data/confluence
- Start Confluence