JIRA has a number of advanced configuration options, each of which is defined as an individual property (or 'key' associated with a value). These key-value pairs are stored in one of three areas for use by JIRA: The JIRA DatabaseThe values of a small number of most commonly edited advanced configuration options are stored in the JIRA database. These values can be edited from the Advanced Settings page of JIRA's administration area (accessible by JIRA system administrators from the System > General Configuration menu > Advanced button). Once any of these properties' values are changed, they become effective immediately. See Configuring Advanced Settings for details. The |
|
Making changes to the jira-config.properties file
To make changes to the jira-config.properties file:
- Shut down JIRA (for example, by executing either the
/bin/stop-jira.shor\bin\stop-jira.batfile in your JIRA Installation Directory, or by stopping the JIRA service). - Open the
jira-config.propertiesfile (located at the root of your JIRA Home Directory) in a text editor.
This file may not exist if you are using a new JIRA installation or an upgraded JIRA installation where your previous JIRA version(s) had never been customised. If this file does not exist, create it using a text editor. - Edit the appropriate properties in this file.
Editing tips:- To determine the default value of a property whose value you wish to redefine, search for that property in the
<jira-application-dir>/WEB-INF/classes/jpm.xmlfile (of your JIRA Installation Directory). The default value is defined in the<default-value/>sibling element of the relevant property's<key/>element. - To override a property's default value in
jpm.xml(which is not already defined in yourjira-config.propertiesfile or available on the 'Advanced Settings' page):- Copy the value of the relevant property's
<key/>element from thejpm.xmlfile to thejira-config.propertiesfile. - In the
jira-config.propertiesfile, add an '=' after that property's key, followed by your custom value.
- Copy the value of the relevant property's
- To disable a custom property's value in the
jira-config.propertiesfile, either 'comment out' the property with a preceding '#' symbol or remove the property from the file.
- To determine the default value of a property whose value you wish to redefine, search for that property in the
- Save your modifications to the
jira-config.propertiesfile. - Restart JIRA.
See also
Setting Properties and Options on Startup — for changes like setting available memory, disabling email, enabling Jelly, etc.