Purpose

This article covers how to specifically make changes to the jira-config.properties file located in <jira-home> directory as is also outlined in Advanced JIRA application configuration.

C:\Program Files\Atlassian\Application Data\JIRA

/var/atlassian/application-data/JIRA

Solution

• Custom values for remaining advanced configuration options (i.e. not stored in the JIRA application database) are stored as individual key-value pairs in a file called jira-config.properties (located in the JIRA application home directory).

• To make changes to the jira-config.properties file:

  1. Shut down your JIRA applications (for example, by executing either the /bin/stop-jira.sh or \bin\stop-jira.bat file in your JIRA applications Installation directory, or by stopping the JIRA application service).

  2. Open the jira-config.properties file (located at the root of your JIRA application home directory) in a text editor.

     This file may not exist if you are using a new installation or an upgraded installation where your previous JIRA application versions had never been customized. If this file does not exist, create it using a text editor.

  3. Edit the appropriate properties in this file.

     • To determine the default value of a property whose value you wish to redefine, search for that property in the jpm.xml file, which is located in the atlassian-jira/WEB-INF/classes subdirectory 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 your jira-config.properties file or available on the 'Advanced Settings' page):
       
       1. Copy the value of the relevant property's <key/> element from the jpm.xml file to the jira-config.properties file.
       2. In the jira-config.properties file, add an '=' after that property's key, followed by your custom value.
     • To disable a custom property's value in the jira-config.properties file, either 'comment out' the property with a preceding '#' symbol or remove the property from the file.
  4. Save your modifications to the jira-config.properties file.
  5. Restart your JIRA applications.

  In new JIRA application installations, this file may not initially exist and if so, needs to be created manually.

jira.projectkey.warning = testwarning
jira.projectkey.description = testdescription