Clear data from Bitbucket Server instance

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

Summary

The purpose of this article is to clarify how to clear data from the Bitbucket instance in order to reconfigure the instance from scratch.

Environment

  • Bitbucket Server/DC

Solution

⚠️ Be aware this procedure will wipe out all the current data in the Bitbucket instance.

  1. Log into the instance with the Administrator account, then go to Support > Atlassian Support Tools, click the System Information tab and determine:

    1. Which directory is being used as Home Directory;

    2. The database that the instance is connected to.

  2. Shutdown the instance

  3. Delete the contents of the Home Directory (or move it elsewhere)

  4. Erase all the content from the current Bitbucket database instance by dropping (drop command) the database being used by that instance (you can create a database dump before), then recreate it.

  5. After doing these steps above, the next time you try to start that instance you will go through its Setup Wizard again.

Updated on April 24, 2025

Still need help?

The Atlassian Community is here for you.