reference deployment

Bitbucket Data Center on AWS

Code collaboration with high availability and scalability on the AWS Cloud

This Quick Start sets up a flexible, scalable Amazon Web Services (AWS) Cloud environment, and launches Bitbucket Data Center automatically into a configuration of your choice.

Bitbucket Data Center is a Git repository management solution from Atlassian. It provides source code collaboration for enterprises that require high availability and performance at scale. 

This Quick Start uses the Atlassian Standard Infrastructure (ASI) as a foundation. You can also deploy Jira products and Confluence Data Center within the same ASI.


This Quick Start was developed by Atlassian in collaboration with AWS. Atlassian is an APN Partner.

AWS Service Catalog administrators can add this architecture to their own catalog.  

  •  What you'll build
  •  How to deploy
  •  Cost and licenses
  •  What you'll build
  • Use this Quick Start to set up the following Bitbucket Data Center environment on AWS:

    • A virtual private cloud (VPC) configured with public and private subnets. This provides the network infrastructure for your Bitbucket Data Center deployment.*
    • Amazon Elastic Load Balancing, which works both as a load balancer and a Secure Sockets Layer (SSL) termination reverse proxy.
    • In the public subnets: 
      • Managed network address translation (NAT) gateways to allow outbound internet access for resources in the private subnets.*
      • A Linux bastion host to allow secure access to your Bitbucket application.*
    • In the private subnets:
      • A Bitbucket Data Center cluster with instances based on Amazon Linux.
      • Amazon Relational Database Service (Amazon RDS) PostgreSQL as the external database for Bitbucket Data Center. You can choose Amazon Aurora PostgreSQL instead.
      • A network file system (NFS) server instance. This provides a shared file system with an attached Amazon Elastic Block Store (Amazon EBS) volume for storing repositories.
    • Amazon Elasticsearch Service (Amazon ES) for Elasticsearch 2.3 indexing and searching functionality.
    • Amazon CloudWatch for basic monitoring of all application and database nodes in your deployment. By default, CloudWatch also collects and stores logs from each monitored node.

    * If you're deploying Bitbucket into an existing Atlassian Standard Infrastructure (ASI), the Quick Start detects the components marked by asterisks, and provisions Bitbucket into your existing ASI. 

  •  How to deploy
  • Build your Bitbucket Data Center cluster in a few simple steps:

    1. If you don't already have an AWS account, sign up at
    2. Launch the Quick Start. You can choose to build a new Atlassian Standard Infrastructure (ASI) for your deployment or deploy Bitbucket into your existing ASI:
    3. Configure Bitbucket Data Center for multiple nodes.
    4. Add nodes to the cluster.

    To customize your deployment, you can choose different instance types for your resources, configure your cluster nodes, and adjust file server and database settings.

    Amazon may share user-deployment information with the AWS Partner that collaborated with AWS on the Quick Start.  

  •  Cost and licenses
  • You are responsible for the cost of the AWS services used while running this Quick Start reference deployment. There is no additional cost for using the Quick Start.

    The AWS CloudFormation template for this Quick Start includes configuration parameters that you can customize. Some of these settings, such as instance type, will affect the cost of deployment. See the pricing pages for each AWS service you will be using for cost estimates. Prices are subject to change.

    Tip   After you deploy the Quick Start, we recommend that you enable the AWS Cost and Usage Report to track costs associated with the Quick Start. This report delivers billing metrics to an S3 bucket in your account. It provides cost estimates based on usage throughout each month, and finalizes the data at the end of the month. For more information about the report, see the AWS documentation.

    This Quick Start requires a Bitbucket Data Center license. For information about obtaining a license, see the Atlassian pricing page. The Quick Start can't be used with Bitbucket Server licenses.

    If you want to evaluate Bitbucket Data Center, you can also request an evaluation license when you configure the product after deployment.