How to set file system permissions for Confluence
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
Summary
In order to work properly, Confluence requires complete access to its files and directories.
Many issues might surface when the account running the Confluence process doesn't have permission to write or to read files in the home directory.
Solution
the steps below assume that you are running Confluence Datacenter in your environment, if that's not the case please skip the <confluence-shared-home-folder> steps
Linux
Run the commands below then restart Confluence.
Replace <confluence-user> with the dedicated user account that runs the Confluence process, and <confluence-install-folder> and <confluence-home-folder> with the appropriate values.
- To find the home folder, check this article Confluence Home and other important directories
sudo chown -R <confluence-user> <confluence-install-folder>
sudo chown -R <confluence-user> <confluence-home-folder>
sudo chown -R <confluence-user> <confluence-shared-home-folder>
sudo chmod -R u=rwx,g=rx,o=rx <confluence-install-folder>
sudo chmod -R u=rwx,g=rx,o=rx <confluence-home-folder>
sudo chmod -R u=rwx,g=rx,o=rx <confluence-shared-home-folder>
you can also write the permissions numerically. i.e: sudo chmod -R 755 <confluence-user> <confluence-install-folder>
Windows
- Right click on
<confluence-home-folder>and hit Properties. - Navigate to the Security Tab and make sure that the user running Confluence has Full Control of this folder.
- Do the same for the
<confluence-install-folder> and <confluence-shared-home-folder>folders. - Restart Confluence.
Related Content
Creating a Dedicated User Account on the Operating System to Run Confluence