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.

(info) 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

If you want to evaluate or demonstrate a JIRA application, let us do most of the set up for you. We will help you set up an Atlassian account if you don't have one, and will generate an evaluation license for you. We'll also set up a H2 database for evaluation purposes (see Supported Platforms). The only requirement is you have a connection to the internet, as we'll need this to validate and generate Atlassian account details and your evaluation license.

Follow the steps here.

Production and
testing

If you want to set up a JIRA application for production or testing purposes before you upgrade, we recommend you follow the custom installation path. This will allow you to connect to your own database if required, and set up your email SMTP server. This path can also be followed if you don't have a connection to the internet. You'll be able to manually paste in a license key.

Follow the steps here.

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 LanguageNote:

  • 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 click 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 click 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!

(tick)  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. Note:

  • 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 click 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.
  • The H2 database is suitable for evaluation and demonstration purposes only. We recommend connecting to a supported database for production environments.
Your own database Production use
  1. Choose a database. See our list of supported databases first.
  2. Configure the database connection. If you need help, see the guides on Connecting JIRA to a database. Note, the fields displayed on this screen are identical to those on the JIRA configuration tool.
  • Your external database must be a newly-created (or empty) database.
  • Database connection pool — You cannot configure your database connection pool size through the setup wizard. You can do this subsequently using the JIRA configuration tool or manually (described on each specific database configuration guide). 
  • MySQL database — The MySQL driver is not bundled with JIRA (see Connecting JIRA to MySQL). You need to copy the driver into the lib folder of your JIRA installation and restart JIRA/JIRA service before completing the setup wizard.

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.

  • The application title will be displayed on the login page and the dashboard.
  • After you have completed the setup wizard, you may also want to configure the logo and color scheme of your installation.

Mode

Choose a mode that suits how you use your issue tracker.

  • Setting the mode to public enables public signup. Note, that allowing anyone to sign up can cause you to exceed the user limit on your JIRA application license.
  • A public issue tracker can be useful for gathering feedback and bug reports directly from customers. A private issue tracker may be more suitable for tracking the development progress of your team.

Base URL

Specify the base URL that users will use to access your instance.

  • You can only configure JIRA to respond to a single URL and this setting must match the URL that your users request for accessing your JIRA instance. You cannot (for example) have a different hostname or URL for internal and external users. Any mismatch between this Base URL setting and the URL requested by your JIRA application users will cause problems with dashboard gadgets.
  • This URL is also used in outgoing email notifications as the prefix for links to JIRA issues.

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. Click Finish to complete the setup.

 

(tick) 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.

Was this helpful?

Thanks for your feedback!

Why was this unhelpful?

Have a question about this article?

See questions about this article

Powered by Confluence and Scroll Viewport