JIRA Installation Directory

The 'JIRA Installation Directory' is the directory into which the JIRA application files and libraries have been extracted, either:

JIRA does not modify or store any data in this directory.

Important Files and Directories

The directories/files described below are found under different sub-directories of the 'JIRA Installation Directory', depending on whether you have installed a 'recommended' or WAR distribution of JIRA. Please substitute the following directories for the <jira-application-dir> placeholder (used throughout the rest of this section), as follows:

  • 'Recommended' distributions — the atlassian-jira subdirectory of the 'JIRA Installation Directory' installed using the 'Windows Installer', 'Linux Installer' or from an 'Archive File'.
  • The default installation directory on Linux is:

    /opt/atlassian/jira/

  • WAR distribution — the webapp subdirectory of the 'JIRA Installation Directory'.
    (info) Please Note: To edit files in this webapp directory, first copy them to the edit-webapp subdirectory (if they are not already present in edit-webapp) and edit the copies in edit-webapp. Refer to the 'Webapp Layout' section of the JIRA WAR Configuration Overview for details. Copies of the jira-application.properties and entityengine.xml file are already available in the edit-webapp sub-directory.
 

<jira-application-dir>/atlassian-jira/WEB-INF/classes/jira-application.properties

This file tells JIRA where to find the JIRA Home Directory.
(warning) Be aware that your JIRA Home Directory defined in this file can be overridden. See Setting your JIRA Home Directory for more information.

<jira-application-dir>/atlassian-jira/WEB-INF/classes/jpm.xml

This file stores the default values for JIRA's advanced configuration settings and should not be modified. The default values of properties in this file are customized (i.e. overridden) by redefining them in either the jira-config.properties file (in your JIRA Home Directory) or the JIRA database (via the JIRA administration area). See Advanced JIRA Configuration for more information.

<jira-application-dir>/atlassian-jira/WEB-INF/lib/

This is the directory where plugins built on Atlassian's Plugin Framework 1 (i.e. 'Plugins 1' plugins) are stored. If you are installing a new 'Plugins 1' plugin, you will need to deploy it into this directory.
'Plugins 2' plugins should be stored in the JIRA Home Directory.

<jira-application-dir>/atlassian-jira/WEB-INF/classes/log4j.properties

JIRA's logging configuration file. See Logging and Profiling.

The actual log files generated by JIRA can be found in the following locations:

  • JIRA application logbin/atlassian-jira.log
  • Application server log — generally the application server log file can be found under the logs directory. However, this can vary depending on the application server you are running. Please see Where are the application server logs? for further details.

<jira-application-dir>/atlassian-jira/WEB-INF/classes/entityengine.xml

This file configures the OFBiz Entity Engine which JIRA uses to store persist data in a datasource. See Configuring the Entity Engine for JIRA.

The sub-directories/files described below are found under the root of the JIRA Installation directory.

 

conf/server.xml

This file is used for JIRA SSL configuration. See Running JIRA over SSL or HTTPS.

Memory Settings

The file used to edit JAVA_OPTS memory settings will depend on the method used to install JIRA, as well as the operating system used for your installation.

For example, if you are running JIRA on Tomcat in Windows (manual startup), you would update the following file:
bin\setenv.bat
whereas for JIRA on Tomcat in Linux/Unix, you would update this file:
bin/setenv.sh

See Increasing JIRA Memory for further details.

Was this helpful?

Thanks for your feedback!

7 Archived comments

  1. User avatar

    Anonymous

    1. Stop your instance,
    2. Simply comment out the <Listener SSLEngine="on" className="org.apache.catalina.core.AprLifecycleListener"/> in Tomcat conf/server.xml file
    3. Restart
    22 Sep 2012
  2. User avatar

    Kevin Mote

    This is confusing. I came here simply to determine what the 'JIRA Installation Directory'  is on Windows. I expected a statement, somewhere near the top of this page stating

    • The default installation directory on Windows (for "Recommended" distributions) is:

    C:\Program Files\Atlassian\JIRA

    It is also confusing that you are using 'JIRA Installation Directory' interchangeably with 'JIRA Application Directory' (in the placeholder). Actually, if the "Application Directory" really is the atlassian-jira subdirectory of the "Installation Directory" (as stated in the first information box), then atlassian-jira / should be removed from all the paths on the remainder of the page.

     

     

    23 Jan 2014
    1. User avatar

      Paul Nichols

      Seconded.  Very confused between relationship of `JIRA Home Directory`, `JIRA Installation Directory`, and `JIRA Application Directory`.

      02 Apr 2014
      1. User avatar

        Sir Be

        Default JIRA home directory is C:\Program Files (x86)\Atlassian\Application Data

        JIRA installation directory is C:\Program Files (x86)\Atlassian\JIRA 4.2.4-b591 (question)

        JIRA application directory is  C:\Program Files (x86)\Atlassian\Application Data (question)

        10 Apr 2014
        1. User avatar

          Harry Kashouli

          That makes no sense. If:

           - JIRA application directory, &

           - jira-application-dir, &

           - JIRA home directory

          are the same thing, then why am I putting a file (jira-application.properties) inside the same folder it references with the jira.home property?

          I'm beginning to understand why every admin at work hates Jira...

          EDIT: Well, these are two days of my life that I won't ever get back. I hate when people post incorrect responses. In reality, there are only two folders:

           - JIRA installation folder (also referenced as <jira-application-dir> in the help documentation)

           - JIRA home folder

          Proof: Important Directories and Files

          25 May 2015
  3. User avatar

    Fahad V A

    If we change the installtion directory, will it affect Jira.

    need help with the steps for doing it..

     

    23 Apr 2014
Powered by Confluence and Scroll Viewport