How to fix JIRA Directories permission in Linux

Still need help?

The Atlassian Community is here for you.

Ask the community

This article only applies to Atlassian's server products. Learn more about the differences between cloud and server.

Problem 

On many occasions, JIRA is not able to run properly due to file or directory permission error

Solution

  1. You will first need to find out the user who installed JIRA. There are 3 methods to do this :

    1. From The System Info page on your JIRA instance :


    2. From the Support Zip ( application.xml file ) search for <JIRA_USER>

    3. From the $JIRA_HOME/log/atlassian-jira.log, search for 'user.name'

  2. You will also need to know the group the user belongs to run JIRA and most of the time the group name is the same as the username that runs JIRA.  

    If you're unsure of what these permissions should be, please consult with your System Administrator and the user who installed JIRA.

    If you are the user who installed Jira, you can see these details by running these commands:

    	whoami (this will tell your exact username)
    	id -g -n (this will tell your group name)
  3. Next, execute the 2 lines below to fix the permission of the JIRA Home & Installation directory

    sudo chown -R jirauser:jiragroup /path/to/jirahome
    sudo chown -R jirauser:jiragroup /path/to/jirainstall
    
    chmod -R u=rwx,g=rx,o=rx /path/to/jirahome
    chmod -R u=rwx,g=rx,o=rx /path/to/jirainstall

    Substitute Jira with the correct user that installed JIRA and the path with the correct path to the respective directory 

  4. Restart JIRA

Problem 

The permissions are correct after running the commands to fix the permission of the JIRA Home & Installation directory.

JIRA fails to startup with the following error:

Setup: JIRA couldn't create the jira.home directory
Ensure JIRA has permission to create and write to the jira.home directory /jira-home.
Review our documentation for more information on setting your JIRA home.

Solution

This can be caused by a symbolic link hidden in the JIRA Home directory.

Follow the Resolution in Symbolic Link in JIRA Home during upgrading using Installer will throw 'java.lang.OutOfMemoryError: GC overhead limit exceeded'.

Description On many occasions, JIRA is not able to run properly due to file or directory permission error
Product Jira
Platform Server
Last modified on May 13, 2019

Was this helpful?

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