Running the Setup Wizard
The JIRA Setup Wizard helps you configure the basic settings for your new JIRA server. These include the server language, database, license key, administrator accounts and mail notifications.
To get started, access your new JIRA server in a browser, after you have installed JIRA. Your server will be available at the following URL, if you are using the default port: http://<jira-server-name>:8080
.
The JIRA Setup Wizard will only display the first time after you install JIRA. Once you have completed it, you cannot run it again. However, every setting configured in the Setup Wizard can be configured via the JIRA administration console.
On this page:
Step 1. Configure the language and database
Screenshot: Configuring the server language and database connection for a new JIRA server
Set the server language
Choose the language you would like the JIRA user interface to appear in by selecting the preferred Server Language.
Please Note:
- As soon as you choose a language from the Server Language dropdown list, the JIRA user interface will switch to that language.
- Be aware that some languages may have more comprehensive translations than others.
Configure a database for JIRA
Choose between connecting JIRA to the bundled database or your own database.
Database Connection | Recommended for | Instructions | Notes |
---|---|---|---|
Bundled database | Evaluations only | Go to the next step. The bundled HSQL database will be automatically configured by the Setup wizard. |
|
Your own database | Production use |
|
|
Step 2. Configure the application properties
Screenshot: Configuring the application properties for a new JIRA server
Configure the Title, Mode and Base URL
Setting | Instructions | Notes |
---|---|---|
Application Title | Choose a title that helps identify your installation and its purpose. |
|
Mode | Choose a mode that suits how you use your issue tracker. |
|
Base URL | Specify the base URL that users will use to access your JIRA site. |
|
Further information:
- If you need to change these settings after setting up JIRA, you can configure them via the JIRA administration console. For details, see Configuring JIRA Options.
- JIRA will store your automated backups, file attachments and indexes in your JIRA Home Directory.
(Optional) Import data into your JIRA installation
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 data link. The 'Import Existing Data' page will display — see Restoring Data for further instructions.
Please also note:
- Your XML backup file must be located in the
import
subdirectory of your JIRA Home Directory. - Your existing JIRA license details will be restored from your XML backup file, unless you specify different one in the License field of the 'Import Existing Data' page.
Step 3. Specify your license key
Screenshot: Creating a my.atlassian.com account and license key
Screenshot: Generating a license key for an existing my.atlassian.com account
Screenshot: Entering an existing license key (from a my.atlassian.com account)
You are required to enter a JIRA license key before you can use JIRA. If you don't have a JIRA license key, you can get the Setup Wizard to create an evaluation license for you, as shown above. Evaluation license keys will allow you to use a fully functional installation of JIRA for 30 days.
License keys for Atlassian products are linked to your account at my.atlassian.com. If you don't have a my.atlassian.com account, you can create one and get the Setup Wizard to create an evaluation license for you, as shown above.
Some customers have encountered Javascript and CSS errors on the 'Specify Your License Key' page. See this knowledge base article: [ARCHIVED] JIRA Setup Wizard Fails with Errors on Licence Key Setup Page.
Step 4. Set up the administrator account
Screenshot: Setting up a JIRA system administrator account
Enter the details for the administrator account for the JIRA installation. The account will be granted the JIRA system administrator permission.
You can create additional JIRA system administrator and JIRA administrator accounts after you have set up JIRA.
Step 5. Configure email notifications
Screenshot: Setting up email notifications for JIRA
This step is optional. You can configure email notifications after you have set up JIRA if you wish.
If you want to configure email notifications at this stage, you will need to set up a connection to a mail server. See this page for further instructions: Configuring JIRA's SMTP Mail Server to Send Notifications
Congratulations, you have completed setting up your new JIRA installation!
Next steps
The Welcome screen will lead you through creating demonstration project for your new JIRA installation, or you can opt to set it up yourself.
For more information on getting started with JIRA, see the JIRA 101 guide.
Detailed information on using and administering JIRA can be found in the rest of the JIRA documentation: