This server will be upgraded at 3pm Sydney time on December 3rd (December 2nd, 8pm PST) and will be down for up to 30 minutes.
This documentation relates to the latest version of Confluence.
If you are using an earlier version, please go to the documentation home page and select the relevant version.

Confluence Data Directory Configuration

Added by Jeremy Higgs, last edited by Edwin Dawson [Atlassian] on May 13, 2008  (view change) show comment
All Versions
Click for all versions
Confluence 2.10 Documentation

Index

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, this path:

C:\confluence\data

will be written like so:

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/
Symbolic links

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.

Labels

confluence confluence Delete
installation installation Delete
admin admin Delete
configuration configuration Delete
directory directory Delete
Enter labels to add to this page:
Please wait 
Looking for a label? Just start typing.