Install a Bitbucket Server trial

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


On this page

If you're ready to set up a production instance of Bitbucket Server, 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 Server 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 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. Click either Go to Bitbucket - to go straight to the Bitbucket Server interface, or Integrate with JIRA - to create your connection with an existing JIRA application. 

    Tell me more...

    You can also chose 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 elect to do this later.

Start using Bitbucket Server

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

What's next?

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


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

Last modified on Jun 5, 2017

Was this helpful?

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