Documentation for JIRA 4.4. Documentation for other versions of JIRA is available too.
After you have installed JIRA Standalone or WAR and have 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.
On this page:
The first page of the Setup Wizard is shown below.
On this page you can choose between connecting JIRA to:
You can also choose the language you would like the JIRA user interface to appear in by clicking the relevant flag.
Be aware that some languages may have more comprehensive translations than others.
If you choose to connect JIRA to an external database by clicking the 'External' radio button, you will be presented with a number of database configuration options.
Your external database must be a newly-created (or empty) database. For more information on creating a database, refer to step 2 (for creating/configuring a database) of the appropriate documentation for your database:
To configure your external database connection:
Please Note:
On this page you can configure some of JIRA's settings and enter your license key. For more details on the settings and what they mean, see Configuring JIRA Options.
JIRA will store your automated backups, file attachments and indexes within your JIRA Home Directory.
If you have an existing XML backup of a JIRA site, you can import it into your new JIRA installation at this point by clicking the top 'import your existing data' link. See Restoring Data for details on using this feature.
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:
After completing the second step, the third page of the wizard sets up an administrator account.
Once this initial administrator account is created, that administrator can then create other administrators.
The last page of the Setup Wizard allows you to configure the outgoing emails from JIRA.
To enable or disable email notifications (you can always enable them later), select the respective Enable or Disable radio buttons.
If you enable email notifications, you will need to set up a connection to a mail server, as indicated in the following screenshot.
Once you complete step 4, JIRA should be set up and ready for use.
Click 'log in to JIRA' to start using JIRA!
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.
Due to a known issue in JIRA 4.4.0, the Setup Wizard currently does not add an important MySQL setting to JIRA's database configuration, which is required to avoid data corruption. To work around this issue:
If you are using JIRA 4.4.1 or later, you do not need to worry about adding this parameter as this issue has been addressed.