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

This widget could not be displayed.

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!



This widget could not be displayed.

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.

This widget could not be displayed.
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 →

Suggest an answer

Log in or Sign up to answer
Atlassian Summit 2018

Meet the community IRL

Atlassian Summit is an excellent opportunity for in-person support, training, and networking.

Learn more
Community showcase
Posted 10 hours ago in New to Jira

Are you planning to trial, or are currently trialling Jira Software? - We want to talk to you!

Hello! I'm Rayen, a product manager at Atlassian. My team and I are working hard to improve the trial experience for Jira Software Cloud. We are interested in   talking to 20 people planning t...

32 views 1 0
Join discussion

Atlassian User Groups

Connect with like-minded Atlassian users at free events near you!

Find a group

Connect with like-minded Atlassian users at free events near you!

Find my local user group

Unfortunately there are no AUG chapters near you at the moment.

Start an AUG

You're one step closer to meeting fellow Atlassian users at your local meet up. Learn more about AUGs

Groups near you