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

Skip to end of metadata
Go to start of metadata

After you have installed JIRA, and accessed its URL (eg. http://localhost:8080 or http://localhost:8080/jira ) for the first time, you will be presented with a brief setup wizard to configure JIRA.

Step 1 of 3: Application Properties

The first page of the wizard is shown below. On this page you can set some of the JIRA configuration settings, and enter your license key.

We strongly recommend that you specify a backup path as this will allow JIRA to periodically backup the database.

JIRA configuration settings

For more details on the settings and what they mean, see Configuring JIRA.

The first page of the wizard will also prompt you to accept locations for the following features or disable them altogether:

For security reasons, from JIRA version 4.2, you can no longer specify custom directories for your Automated Backups, File Attachments and Indexes.

Evaluation license key

You are required to enter a valid license key before you can use JIRA. You can obtain an evaluation license key which will allow JIRA to run unrestricted for 30 days. To use your existing license key or obtain a new license key, follow the steps below:

  1. If you are a new user, you will need to create an account to generate an evaluation license key. Otherwise, log in to the Atlassian website and navigate to the 'Licenses' page.
  2. Once you have created an account or logged in with an existing account, the 'JIRA - Licenses' page will display with a list of your existing JIRA licenses. If you do not have any JIRA licenses, generate one by clicking on the 'Generate evaluation license' link for JIRA. A new evaluation license will be generated and displayed on the page.
  3. Click on the 'View' link to view the license key of the evaluation license that you wish to use. Copy the license key to your clipboard and paste it into the 'License Key' field of the Setup Wizard.

Step 2 of 3: Administrator Account

After completing the first page, the second page of the wizard sets up an administrator account.

Once this initial administrator account is created, that administrator can then create other administrators.

Step 3 of 3: Email Notification

The last page of the setup wizard allows you to configure the outgoing emails from JIRA.

To disable email notifications (you can always enable them later), just click the Disable Email Notifications button.

For the outgoing mail server choice, you must either specify the JNDI location of a javax.mail.Session object (usually provided by your application server) or specify the location of an SMTP server.

You're done!

Once you complete step 3, JIRA should be set up and ready for use. For information on getting started with JIRA, please refer to the following guides:

Also note that you can click the help icon (yellow question-mark) in the upper right-hand corner at any time for further information.