Documentation for JIRA 4.4. Documentation for other versions of JIRA is available too.

You are viewing an old version of this page. View the current version.

Compare with Current View Page History

Version 1 Current »

About the JIRA Configuration Tool

The JIRA Configuration Tool is an application (included with JIRA Standalone) which offers server-level JIRA configuration through a convenient GUI. This tool allows you to conveniently configure:

Whenever you configure or reconfigure JIRA's server-level settings using this tool, JIRA must be restarted so it can recognise these changes.

(info) Please Note:

  • The JIRA Configuration Tool requires a Java platform to be installed and configured on your operating system. We recommend using a Java platform supported by JIRA — refer to JIRA Requirements for details.
  • If you use the JIRA WAR distribution or have a console-only connection to your JIRA server, you will need to perform these server-level configurations manually.

On this page:

Starting the Configuration Tool

To start the JIRA Configuration Tool:

(info) Please Note: You may need to set the JAVA_HOME environment variable to run the JIRA Configuration Tool. See Installing Java for details.

Configuring the JIRA Home Directory

Your JIRA Home Directory allows you to set the folder that JIRA uses to store its various data files.

To set your JIRA Home Directory using the JIRA Configuration Tool:

  1. Click the 'JIRA Home' tab.
  2. In the 'JIRA Home Directory' field, type the full file path into the text field, or click the 'Browse' button to browse for the location of your JIRA Home Directory.

    (info) Upon clicking the 'Save' button, your changes are saved to the jira-application.properties file located in the <jira-application-dir> subdirectory of your JIRA Installation Directory.

    For more information, please see Setting Your JIRA Home Directory.

Configuring the Database Connection

To configure JIRA's database connection using the JIRA Configuration Tool, follow the appropriate procedure for your database type:

Configuring JIRA's TCP Ports

JIRA runs on TCP listening (HTTP) port 8080 and shutdown (Control) port 8005 by default. However, you can change these ports if they are already being used by an existing service running on the same machine.

To change JIRA's TCP ports using the JIRA Configuration Tool:

  1. Click the 'Web Server' tab.
  2. In the 'HTTP Port' field, enter the new TCP listening port number.
  3. In the 'Control Port' field, enter the new TCP shutdown port number.

    (info) Upon clicking the 'Save' button, your changes are saved to the server.xml file located in the conf subdirectory of your JIRA Installation Directory.

    For more information, please see Changing JIRA's TCP Ports.

Saving your settings

Click the 'Save' button when you are done. This saves all configuration changes made in all tabs of the JIRA Configuration Tool.

JIRA must be restarted for your new settings to take effect.

  • No labels



See our Getting Help page for details.



Raise an issue for our developers.



See answers from the community.



Tweet, blog and update our documentation.

Except where otherwise noted, content in this space is licensed under a Creative Commons Attribution 2.5 Australia License.