The JIRA Database
The 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. To access the values for editing:
- Log in as a user with the JIRA Administrators global permission.
- See Configuring Advanced Settings for details.
Once any of these properties' values are changed, they become effective immediately.
Custom values for JIRA's remaining advanced configuration options (i.e. not stored in the JIRA database) are stored as individual key-value pairs in a file called
jira-config.properties (located in the JIRA Home Directory). Typically, these options are of little interest to most JIRA system administrators. While these key-value pairs can be edited, JIRA must be restarted for any changed values to take effect.
jira.projectkey.warning = testwarning
jira.projectkey.description = testdescription
In new JIRA installations, this file may not initially exist and if so, needs to be created manually. For more information about editing the
jira-config.properties file see here: How to edit the jira-config.properties file
Default values for all* of JIRA's available advanced configuration options are stored in a file called
jpm.xml (located in the
<jira-application-dir>/WEB-INF/classes subdirectory of the JIRA Installation Directory). These default values are only used by JIRA if a property's value has not already been customized in either the JIRA database (via JIRA's 'Advanced Settings' page) or the
jpm.xml file should not be edited because any values that you customize in it will not be migrated automatically during subsequent JIRA upgrades. To change the value of a property for an advanced configuration option in JIRA, override the value of this property by redefining it in either:
- The JIRA database (via JIRA's 'Advanced Settings' page).
* JIRA recognises a small number of properties, which can be set in your
jira-config.properties file but have no definition in the
jpm.xml file. These properties:
- typically represent advanced configuration options that are disabled when they are not defined in your
jira-config.properties file and
- when not specified in your
jira-config.properties file, typically affect JIRA's behavior differently to when they are specified in your
jira-config.properties file with no value.