Jira application 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 Windows, Linux or Archive 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-jirasubdirectory of the 'Jira Installation Directory' installed using the 'Windows Installer' and 'Linux Installer', and there associated installations from archive files (.zip and tar.gz respectively).
The default installation directory on Linux is:
This file tells Jira where to find the Jira application home directory.
Be aware that your Jira home directory defined in this file can be overridden. See Setting your Jira application home directory for more information.
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 application home directory) or the Jira database (via the Jira administration area). See Advanced Jira configuration for more information.
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 application home directory.
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 log —
- Application server log — generally the application server log file can be found under the
logsdirectory. However, this can vary depending on the application server you are running.
This file configures the OFBiz Entity Engine, which Jira uses to store persist data in a data source.
This file includes garbage collection (GC) logs that are used to improve the performance of Jira applications. The log statements indicate when Java is collecting garbage, how long this process takes, and how much memory has been freed. The file is generated automatically, and is also included in the Support Zip package. For more info, see Using garbage collection logs.
The sub-directories/files described below are found under the root of the Jira application installation directory.
This file is used for Jira SSL configuration. See Running Jira applications over SSL or HTTPS.
These files include garbage collection (GC) logs that can be used to monitor the performance of Jira applications. The log statements indicate when Java is collecting garbage, how long this process takes, and which resources can be freed. The files are created automatically, and then overwritten if the maximum number of files (5) is reached. The timestamp indicates when the Jira session related to the logs was started. For more info, see Using garbage collection logs.
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:
whereas for Jira on Tomcat in Linux/Unix, you would update this file:
See Increasing Jira memory for further details.