Documentation for Confluence 2.5.4 - 2.5.8.
Documentation for [Confluence Cloud] and the latest Confluence Server is available too.

Here is a link listing important Confluence files.

The home directory defines the location of the directory where Confluence will store it's data, including attachments, indexes and backups. Administrators can set this location by defining a value for the file <MY-INSTALL>/confluence/WEB-INF/classes/confluence-init.properties. To find what your home directory is currently set to, open this file and check the confluence.home property. It is unset on new installations.

 Windows Configuration

On Windows, the path

C:\confluence\data

will be written as:

confluence.home=C:/confluence/data

Note that all backslashes (\) are written as forward slashes (/).

 UNIX/Linux/Mac Configuration

On any UNIX-based system, the property is defined using the normal directory syntax:

confluence.home=/var/confluence/

If your confluence.home directory contains a symbolic link, you must define the absolute path.

Please note that there can be no symbolic links within the confluence.home directory. If disk space is an issue, place the entire confluence.home directory on a disk partition where there is enough space.

The absolute path of generated files (such as exports) is compared with the absolute path of the confluence.home directory when constructing URLs. When a sub-directory has a different path, the URL will be incorrect, and you may receive "Page not found" errors. These measures are in place to prevent "directory traversal" attacks.

Fixing the Confluence Configuration

The Confluence configuration file: confluence-cfg.xml inside the home directory may contain references to the original location of your Confluence home. You will need to edit this file to update these references to also point to the new location. The two properties in this file that need to change are:

  • daily.backup.dir if you have not configured your backups to be placed elsewhere already
  • hibernate.connection.url if you are using the embedded HSQL database.





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