How to set file system permissions for Confluence

Still need help?

The Atlassian Community is here for you.

Ask the community

Platform notice: Server and Data Center only. This article only applies to Atlassian products on the Server and Data Center platforms.

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



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.


(warning) 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


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.

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>

(info) you can also write the permissions numerically. i.e: sudo chmod -R 755 <confluence-user> <confluence-install-folder> 


  1. Right click on <confluence-home-folder> and hit Properties.
  2. Navigate to the Security Tab and make sure that the user running Confluence has Full Control of this folder. 
  3. Do the same for the <confluence-install-folder> and <confluence-shared-home-folder> folders.
  4. Restart Confluence.

Related Content

Creating a Dedicated User Account on the Operating System to Run Confluence

Last modified on Nov 27, 2023

Was this helpful?

Provide feedback about this article
Powered by Confluence and Scroll Viewport.