Install Bitbucket Data Center on Linux

This page describes how to install Bitbucket Data Center in a production environment, with an external database, using the Linux installer.

This is the most straightforward way to get your production site up and running on a Linux server.



Other ways to install Bitbucket Data Center: 

  • Evaluation - get your free trial up and running in no time.
  • TAR.GZ – install Bitbucket Data Center manually from an archive file.

On this page

Before you begin

Before you install Bitbucket Data Center, there are a few questions you need to answer. 

Are you using a supported operating system?
Tell me more...

Check the Supported Platforms page for the version of Bitbucket Data Center you are installing. This will give you info on supported operating systems, databases and browsers.

Good to know:

  • We don't support installing Bitbucket Data Center on macOS for production sites.
  • The Bitbucket Data Center installer includes Java (JRE) and Tomcat, so you don't need to install these separately.
Do you want to run Bitbucket Data Center as a service?
Tell me more...

Running Bitbucket Data Center as a service means that Bitbucket Data Center will automatically start up when your Linux server is started.

You should use the Linux installer if you want to run Bitbucket Data Center as a service.

If you choose not to run Bitbucket Data Center as a service:

  • You will start and stop Bitbucket Data Center by running the start-bitbucket.sh file in your Bitbucket Data Center installation directory.
  • Bitbucket Data Center will be run as the user account that was used to install Bitbucket Data Center, or you can choose to run as a dedicated user.
  • Bitbucket Data Center will need to be restarted manually if your server is restarted.

For more information about these options, see the pages:

Bitbucket uses ports 7990, 7992, and 7993 by default, are they available?
Tell me more...

Port 7990: Bitbucket runs on port 7990 by default. If this port is already in use, see Change the port Bitbucket listens on for more guidance on changing this.

Ports 7992 and 7993: Bitbucket Data Center bundled search server, which is required for search functionality, requires ports 7992 and 7993 be available. This is not configurable, so ensure these ports are available.

Is your database set up and ready to use?
Tell me more...

To run Bitbucket in production you'll need an external database. Check the Supported platforms page for the version you're installing for the list of databases we currently support.

Good to know:

Do you have a Bitbucket Data Center license?

Tell me more...

You'll need a valid license to use Bitbucket Data Center.

Good to know:

  • If you don't have a license you can create an evaluation license during setup, and be sure to use your business email address.
  • If you already have a license key you'll be prompted to log in to my.atlassian.com to retrieve it, or you can enter the key manually during setup.
  • If you're migrating from Bitbucket Cloud (bitbucket.org), you'll need a new license.

Do you have Git and Perl installed and on the right version?
Tell me more...

Bitbucket Data Center requires Git on the machine that will run Bitbucket Data Center. If you need to check, install, or upgrade Git on the Bitbucket Data Center instance machine, see Installing and upgrading Git.

Do not upgrade Git to the latest version until you check the Supported Platforms page for which version of Git is currently supported.

Check that you have all the other system requirements, including Perl, to avoid any trouble.

Install Bitbucket Data Center

1. Download Bitbucket Data Center

Download the installer - www.atlassian.com/software/bitbucket/download.

2. Run the installer

  1. Make the installer executable.

    Show me how to do this...

    Change to the directory where you downloaded Bitbucket Data Center then execute this command:

    chmod +x atlassian-bitbucket-x.x.x-x64.bin

    Where X.X.X is is the Bitbucket Data Center 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 Data Center and allow you to run Bitbucket Data Center as a service.

    Show me how to do this...

    To use sudo to run the installer execute this command: 

    $ sudo ./atlassian-bitbucket-x.x.x-x64.bin

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

    You can also run the installer with root user privileges.

  3. Follow the prompts to install Bitbucket. You'll be asked for the following info:
    1. Type of Bitbucket instance - the type of installation, for these instructions select Standard.
    2. If you're installing Data Center on a single node, also choose Standard, because this type comes with a bundled search server and is suitable for a non-clustered Data Center deployment. In the Data Center type, you would need to install it separately.

    3. Installation directory - where Bitbucket will be installed.
    4. Home directory - where Bitbucket application data will be stored.
    5. TCP ports - the HTTP connector port and control port Bitbucket will run on.
       
  4. Once the installer completes, head to http://localhost:7990 in your browser to begin the setup process.

Set up Bitbucket

The Setup Wizard runs automatically when you visit Bitbucket Data Center in your browser the first time it's started. For details on how the Bitbucket Setup Wizard can be completed automatically, see Automated setup for Bitbucket.

3. Connect to your database 

  1. If you've not already done so, it's time to create your database. See the 'Before you begin' section of this page for details. 

Select External as your database, then choose a Database Type from the dropdown menu and enter the details of your database.


4. Add your license key

Follow the prompts to log in to my.atlassian.com to retrieve your license, or enter a license key.

You can also set the base URL at this step, (you can elect to do this later).

5. 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.

6. Start using Bitbucket Data Center

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 Oct 6, 2023

Was this helpful?

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