Getting started

Atlassian Bitbucket Server is the on-premises Git repository management solution for enterprise teams. It allows everyone in your organization to easily collaborate on your Git repositories.

1. Install Git and Perl

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

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

2. Install Bitbucket Server  

Installers are available for the Linux, Mac OS X and Windows operating systems.

See Running the Bitbucket Server installer for details.

You may be interested in these alternative provisioning approaches:

3. Set up Bitbucket Server

The Bitbucket Server Setup Wizard runs automatically when you visit Bitbucket Server in your browser the first time Bitbucket Server is started. The Setup Wizard guides you to:

  • Specify the default language for Bitbucket Server.
  • Connect Bitbucket Server to an external database (the internal HSQL database is great for evaluating Bitbucket Server, but is not recommended for production installations). You'll need to have created the external database before running the Setup Wizard. For MySQL, you'll need to have installed the JDBC driver too.

If you are intending to use Bitbucket Server for a production installation, see also Using Bitbucket Server in the enterprise.

4. Set up the mail server

Configuring the Bitbucket Server email server allows users to receive a link from Bitbucket Server that lets them generate their own passwords. See Setting up your mail server.

5. Get working with Bitbucket Server

Work with projects

Bitbucket Server manages related Git repositories as projects. Find out how to set up projects and give your teams access to those.

If you have existing projects that you want to manage in Bitbucket Server, then you'll want to read Importing code from an existing project.

Integrate Bitbucket Server with other Atlassian applications

See Integrating Bitbucket Server with Atlassian applications for an overview of what is possible.

As a first step, see JIRA integration for information about using Bitbucket Server with JIRA Software.

If you want to see results from your continuous integration or build server in Bitbucket Server, see Bamboo integration.

Use Bitbucket Server in your enterprise

If you are intending to use Bitbucket Server in large-scale production environments, see:

Use Git

We have some information here to help you get going with Git:

Last modified on Aug 19, 2016

Was this helpful?

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