Setting your JIRA application home directory
How do I set my JIRA home?
There are a few methods available for specifying the location of your JIRA application home directory in JIRA. However, please be aware of the notes below before your specify this location.
Recommended Methods
The recommended methods for specifying the location of your JIRA home directory in JIRA are to:
- Use the JIRA configuration tool to change the location of your JIRA home directory.
- Edit the
jira-application.propertiesfile and set the value of the 'jira.home' property to the desired location for your JIRA home directory (this location should be something different than the application directory, or you may run into problems later). If you are specifying this location's path on Windows, use double back-slashes ("\") between subdirectories. For example,X:\\path\\to\\JIRA\\Home.
If you define an UNC path in Microsoft Windows, be sure to double escape the leading backslash: \\\\machinename\\path\\to\\JIRA\\home
See the JIRA installation directory page to find where this file is located. - Set an environment variable named
JIRA_HOMEin your operating system whose value is the location of your JIRA home directory. To do this:- On Windows, do one of the following:
- Configure this environment variable through the Windows user interface (typically through 'My Computer' or 'Computer')
- At the command prompt, enter the following command (with your own JIRA Home path) before running JIRA from the command prompt:
set JIRA_HOME=X:\path\to\JIRA\Home
Please set your JIRA_HOMEenvironment variable value using this format, where:Xis the drive letter where your JIRA Home Directory is located and- no spacing has been added around the equal sign ('
=')
- Specify the command above in a batch file used to start JIRA.
- On Linux/Solaris, do one of the following:
- Enter the following command at a shell/console prompt (with your own JIRA Home path) before running JIRA:
export JIRA_HOME=/path/to/jira/home
- Specify the command above in a script used to start JIRA.
- Enter the following command at a shell/console prompt (with your own JIRA Home path) before running JIRA:
- On Windows, do one of the following:
Please note: If you have specified different values for a 'jira.home' property in the jira-application.properties file and a JIRA_HOME environment variable, the value of the JIRA_HOME environment variable takes precedence.
Alternative method
Alternatively, you can specify the location of your JIRA home directory as property within your application server:
Configure a new web context property called '
jira.home' for your application server. To do this, you need to define this web context property inside a<parameter/>element (as a child of the<context/>element) in yourserver.xmlfile.
The server.xmlfile is located within theconfsubdirectory of your JIRA application installation directory.<Context ...> ... <Parameter name="jira.home" value="c:/jira/home"/> ... </Context>
Please note: A 'jira.home' web context property defined in your application server overrides the value of the 'jira.home' property defined in your jira-application.properties file. However, a JIRA_HOME environment variable defining your JIRA home directory will override either of these 'jira.home' values.
What location should I specify for my JIRA home?
You can specify any location on a disk for your JIRA home directory. Please be sure to specify an absolute path.
Please note that you cannot use the same JIRA home directory for multiple instances of JIRA. We recommend locating your JIRA Home Directory completely independently of the JIRA installation directory (i.e. not nesting one within the other) as this will minimize information being lost during major operations (e.g. backing up and restoring instances).
How do I change my JIRA home?
- Set your JIRA home to the new location, using your preferred method as described in "How do I set my JIRA home?" (above).
- Restart JIRA.
What is stored in the JIRA home directory?
The following page describes the data stored in the JIRA home directory: JIRA application home directory.
Notes
- If you are using the Windows installer, you do not need to configure the JIRA home directory separately, as you will be prompted to specify this location during the installation process.
- The JIRA installer may not be able to create the home due to permission problems. If this is the case, please see Jira server fails to start with Could not create necessary subdirectory error.