Edit the jira-config.properties file in Jira server

Still need help?

The Atlassian Community is here for you.

Ask the community

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.


You can also use the jira-config.properties file to customize Jira Data Center as long as you deployed through the AWS Quick Start. See Use the jira-config.properties file to customize an AWS Quick Start deployment for instructions.

For more information about deploying Jira Data Center through the AWS Quick Start, see Getting started with Jira Data Center on AWS.


How to find <Jira-Home> location


- If Jira was installed using the automated Windows or Linux installers, the default location of the Jira home directory is:

Windows
C:\Program Files\Atlassian\Application Data\JIRA
Linux
/var/atlassian/application-data/JIRA

Or in the Administration page:

  • Go to Administration > System > System Info > File Paths


Solution

Please note, in new JIRA applications installations, this file may not exist, so it will have to be created.

  • 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.

      tip/resting Created with Sketch.
      • 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.

Example contents to demonstrate format
jira.projectkey.warning = testwarning
jira.projectkey.description = testdescription
DescriptionThis article covers how to specifically make changes to the jira-config.properties file located in <jira-home> directory as is also outlined in our documentation on Advanced JIRA application configuration.
ProductJira
PlatformServer
Last modified on Mar 14, 2023

Was this helpful?

Yes
No
Provide feedback about this article
Powered by Confluence and Scroll Viewport.