Reconfigure Jira server with the Setup Wizard

Platform Notice: Data Center Only - This article only applies to Atlassian products on the Data Center platform.

Note that this KB was created for the Data Center version of the product. Data Center KBs for non-Data-Center-specific features may also work for Server versions of the product, however they have not been tested. Support for Server* products ended on February 15th 2024. If you are running a Server product, you can visit the Atlassian Server end of support announcement to review your migration options.

*Except Fisheye and Crucible

Steps

The following steps will help you reconfigure JIRA by running the setup wizard again.

  1. Stop JIRA

    • If JIRA is running as a JIRA or Tomcat service, stop the relevant service.

    • Otherwise, navigate to script directory inside the JIRA Installation Directory ($JIRA_INSTALL/bin) and run the shutdown.bat (for Windows) or shutdown.sh (for Linux/Solaris) script.

    • If you are running the JIRA WAR distribution, stop Apache Tomcat.

  2. Make a backup of your JIRA Home Directory and JIRA Installation Directory.

  3. From JIRA Home Directory, delete the dbconfig.xml file.

    ℹ️ If you wish to wipe off the data for the instance, drop the database as well.

  4. Start JIRA.

  5. Access your JIRA URL from a browser. Since dbconfig.xml is deleted, JIRA will detect that no database configuration is present and will take you through the JIRA Setup Wizard again.

Updated on April 8, 2025
Platform
Data Center only
Product
Jira Software Data Center

Still need help?

The Atlassian Community is here for you.
Ask the Community