Come for the products,
stay for the community

The Atlassian Community can help you and your team get more value out of Atlassian products and practices.

Atlassian Community about banner
Community Members
Community Events
Community Groups

Datacenter Shared Home Folder permissions

How are the file-level permissions usually configured on the shared home folder for attachments?

All the nodes in the cluster must be able to read and write files created by other nodes in the cluster, and I was wondering how this is usually configured in the file system (as there doesn't seem to be any options in JIRA to change how the files are written).

For my development instance, I created two JIRA instances on the same host. They ended up running under different user ids, and this caused issues because the first node created files as jira1/jira1 rwx------ , which couldn't be read by jira2.

Are there settings in JIRA to configure the group, r/w permissions etc, or is this completely done at the os level; configuring shared groups, umask etc, 

Our plugin also writes files to the shared home directory, should I worry about permissions in my plugin, or is it up to the system admin to configure the file system correctly?

3 answers

1 accepted

1 vote
Answer accepted

Hi Michael,

You are correct in assuming the permissions will need to be setup at the OS level and this would mean the admin would need to ensure the permissions are setup correctly before the plugin will be able to function as expected.

The reason you're seeing two different users is due to two installations on one machine. If you had two machines each one would run under the username jira. This is from the Set up the JIRA file storage location on shared storage section of the Installing JIRA Data Center guide:

There are multiple ways to do this, but the simplest is to use an NFS share. The mechanics of setting one is unique from installation to installation, and is outside the scope of this document. We recommend using a UNC file path to your storage location.

Assuming that the final mount point for this shared storage location is /data/jira/sharedhome :

  1. Ensure that directory can be read and written by other potential nodes
  2. Copy the following directories into /data/jira/sharedhome: (some of them may be empty)
  • plugins
  • logos
  • import
  • export

In light of that you would want to do the following:

  1. Create a shared home folder location potentially on an NFS Share
  2. Ensure the permissions are set so that each node's user would be able to access that folder
  3. Copy the above directories into the home folder

Hopefully that clears things up a bit!



0 votes
Anton Genkin Atlassian Team Apr 16, 2018

Hi, I'm product manager at Atlassian running research on preferable Data Center deployment options. I would highly appreciate if you could answer questions from a short survey on the topic. Your answers will help us a lot in prioritisation of new Data Center deployment options.

Survey →

The default installation does not support the following, as it just goes ahead and creates a local id on each install, but you can do the following:

- create a service account to run JIRA with.  

- set permissions of the local home and shared home directories to this service account

- override JIRA on each node to run under the common account id.  All nodes run under the same guid. 

- if you setup jira to run as a service you can overide the id to run it under by setting value in <JIRA_INSTALL>/bin/ (see

it would be great is the installer would prompt for a service account id, and if none provided then go ahead and create the 'jira' one as it does now.

Suggest an answer

Log in or Sign up to answer

Atlassian Community Events