Install a Bitbucket trial

Want to get up and running with Bitbucket quickly? This page will guide you through the steps to install and set up a trial instance of Bitbucket Data Center.

On this page

If you're ready to set up a production instance of Bitbucket, or you want more control, check out our other installation guides.

Before you begin

Our installers come with all the bits and pieces you need to run the application, but there's a few things you'll need to get up and running:

  • A computer or laptop with a supported operating system - you'll be installing Bitbucket so you'll need admin rights.

    Supported operating systems...

    You can install Bitbucket on a Windows, Linux, or Mac operating system. However Mac isn't supported for production instances.

  • A supported web browser - you'll need this to access Bitbucket, we support the latest versions of Chrome and Mozilla Firefox, Internet Explorer 11, and Microsoft Edge.

  • A valid email address - you'll need this to generate your evaluation license and create an account. Register with your business email domain to access live chat and phone calls with Bitbucket product specialists (for a limited time). 

Ready to get going? Let's start with grabbing the installer.

1. Download the installer

Head to and download the installer for your operating system.

2. Install Bitbucket

The installer allows you to choose the installation and home directories. For this guide we recommend using the default options.


For Windows or Mac
  1. Run the installer - we recommend running with an administrator account.
  2. Choose Install a standard instance, then click Next.
  3. When prompted, choose to start and launch Bitbucket in a browser.
  4. Bitbucket will open in your default browser, and you're ready to start the setup wizard.
    The application will be available at http://localhost:7990.
For Linux
  1. Change to the directory where you downloaded Bitbucket then execute this command to make it executable:

    $ chmod a+x atlassian-Bitbucket-X.X.X-x64.bin

    Where X.X.X is is the Bitbucket version you downloaded.

  2. Run the installer - we recommend using sudo to run the installer as this will create a dedicated account to run Bitbucket and allow you to run Bitbucket as a service.

    $ sudo ./atlassian-Bitbucket-X.X.X-x64.bin
  3. When prompted, choose to start and launch Bitbucket in a browser.
  4. Once installation is complete head to http://localhost:7990 in your browser to begin the setup process. 

3. Set up Bitbucket

The Setup Wizard runs automatically when you visit Bitbucket in your browser the first time it's started.

Add your license key

Follow the prompts and head to where you can generate a trial Data Center license. Be sure to register with your business email domain to access live chat and phone calls with Bitbucket product specialists.

Create your administrator account

  1. Enter details for the administrator account.
  2. Select either Go to Bitbucket to go straight to the Bitbucket interface or Integrate with Jira to create your connection with an existing Jira application. 

    Tell me more...

    You can also select to use a Jira application as your user database during this step. See the page Configuring Jira integration in the Setup Wizard for details. You can also do this later.

Start using Bitbucket

That's it! Your Bitbucket site is accessible from a URL like this: http://<computer_name_or_IP_address>:<port>

What's next?

When setting up Bitbucket in a production environment, we recommend that you configure these aspects next:

Read more about setting up Bitbucket for an enterprise here: Using Bitbucket in the enterprise.

Last modified on Feb 2, 2021

Was this helpful?

Provide feedback about this article
Powered by Confluence and Scroll Viewport.