Running the setup wizard
The Jira setup wizard allows you to either set up a Jira application for evaluation and demonstration purposes or for production and testing.
To get started, access your new Jira application in a browser after you have installed it. Your server will be available at the following URL, if you are using the default port: http://<jira-server-name>:8080.
The Jira application setup wizard will only display the first time after you install your Jira application. 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.
Evaluation and demonstration setup
1. Choose the language you would like the Jira application setup and user interface to appear in by selecting the preferred Language. Note:
- As soon as you choose a language from the Language drop-down list, the Jira application user interface will switch to that language.
- Be aware that some languages may have more comprehensive translations than others.
2. Select Set it up for me and select Next.
3. Enter your Atlassian ID email address, or if you don't have an Atlassian ID account, enter an email address you'd like to use and have access to, and then select Next.
4. We'll validate your account, and create a new one if needed. Remember the details you use for your Atlassian ID account, as these will be the same credentials for your Jira system administrator. You can change the system administrator details within Jira when you're up and running. Check out Managing Global Permissions and Managing Users for more information. Select Next to generate your license.
5. Select Next to finish the setup process. This may take a minute or two.
6. Once the setup is complete, you're ready to get started! Select Launch Jira to get going!
That's it!
Production and testing setup
1. Choose the language you would like the Jira application user interface to appear in by selecting the preferred Language.
- As soon as you choose a language from the Language dropdown list, the Jira application user interface will switch to that language.
- Be aware that some languages may have more comprehensive translations than others.
2. Select I'll set it up myself and select Next.
3. 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 H2 database will be automatically configured by the setup wizard. |
|
| Your own database | Production use |
|
|
4. If you're connecting to your own database, click Test connection to make sure Jira can connect. Click Next when you're ready to proceed.
5. You need to configure the Title, Mode, and Base URL for your instance:
| 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 instance. |
|
Further information:
- If you need to change these settings after setting up your application, 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.
Click Next when you've configured all the application properties to your liking.
6. You are required to enter a Jira application license key before you can use your application. If you don't have a Jira application license key, you can get the setup wizard to create an evaluation license for you. Evaluation license keys will allow you to use a fully functional installation for 30 days.
License keys for Atlassian applications 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.
7. Enter the details for the administrator account for the 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. Click Next when you've entered the details.
8. Set up your email SMTP server. 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. Select Finish to complete the setup.
Congratulations, you have completed setting up your new Jira application installation!
Detailed information on using and administering Jira and your Jira applications can be found in the rest of the Administering Jira applications documentation.