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:
- Installing Bitbucket Server from an archive file
- Docker repository (evaluation only)
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.
Make the most of Bitbucket Server
Automate your Bitbucket Server deployments
Bitbucket Data Center for enterprises
Deploy Bitbucket Server in AWS
Learn Git
Bitbucket Server in action
- Enter your Bitbucket Server license key.
- Set the base URL for Bitbucket Server.
- Set up an administrator account.
- Integrate Bitbucket Server with JIRA.
- Log in to Bitbucket Server.
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:
- Using Bitbucket Server in the enterprise
- High availability for Bitbucket Server
- Scaling Bitbucket Server
- Scaling Bitbucket Server for Continuous Integration performance
- Bitbucket Data Center resources
- Bitbucket Server production server data
Use Git
We have some information here to help you get going with Git: