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

About the JIRA Configuration Tool

The JIRA Configuration Tool is an application (included with all JIRA distributions except JIRA WAR) that 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) 注意:

  • JIRA 設定ツールの利用にあたっては、お使いの OS における Java プラットフォームのインストールおよび設定が必要となります。本ツールを実行するにあたって Java プラットフォームのインストールが必要な場合は、Java platform supported by JIRA の利用をお勧めします。詳しくは、JIRA 要件 を参照して下さい。
  • JIRA WAR のディストリビューションを使用しているか、あるいはお使いの JIRA サーバに対するコンソールのみの接続を有している場合は、これらのサーバレベルの設定を手動で行う必要があります。

On this page:

JIRA 設定ツールの起動

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.

JIRA ホームディレクトリの設定

お使いの JIRA Home Directory は、JIRA がその様々なデータファイルの保管に使用するフォルダーの設定を可能にします。

JIRA 設定ツールを利用して JIRA ホームディレクトリを設定する方法:

  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.

  • ラベルなし