Run Bitbucket in AWS

Administering Bitbucket Server

On this page

Still need help?

The Atlassian Community is here for you.

Ask the community

The AWS Quick Start template as a method of deployment is nearing its end-of-support date on Feb 29, 2024. You can still use the template after this date but we won't maintain or update it.

We recommend deploying your Data Center products on a Kubernetes cluster using our Helm charts for a more efficient and robust infrastructure and operational setup. Learn more about deploying on Kubernetes

This page provides an overview of the options available for running self-managed Bitbucket Data Center and Bitbucket Server instances on Amazon Web Services.

Running Bitbucket on Amazon Web Services (AWS) gives you scalable computing capacity without the need to invest in hardware up front, while retaining control over where and how your code is hosted within your organization.

To this end, Atlassian provides:

  • a reference deployment in the form of an AWS Quick Start, which launches, configures, and runs Bitbucket Data Center and required services in a matter of minutes, using AWS best practices for security and availability
  • an Amazon Machine Image (AMI) that can be used for running Bitbucket on EC2 as an application server building block in more heavily customised deployments
  • tools and guidelines for manually deploying, backing up, restoring, sizing, and administering Bitbucket Server and Bitbucket Data Center instances on AWS
tip/resting Created with Sketch. This page describes deploying a single-node instance of Bitbucket Server on AWS. For a deployment that is better suited to the architectural principles of AWS, we recommend deploying a clustered Bitbucket Data Center instance, which offers greater performance at scale, high availability, and elastic scalability.

Installing Bitbucket Server in AWS

To install Bitbucket Server in AWS, you'll need to launch the Atlassian Bitbucket Server AMI in AWS. You can do this directly from the AWS Console, or by running the EC2 launch wizard. See Launching Bitbucket Server in AWS manually for more information.

Performance guidelines

To get the best performance out of your Bitbucket deployment in AWS, it's important to not under-provision your instance's CPU, memory, or I/O resources. See Recommendations for running Bitbucket Server in AWS for more information.

Whether you choose to deploy Bitbucket Data Center, which offers performance gains via horizontal scaling, or a single node Bitbucket Server instance, we have specific recommendations on choosing AWS EC2 and EBS settings for best performance per node.

Backing up Bitbucket in AWS

Atlassian also provides utilities suitable for backing up and restoring your Bitbucket instance using native AWS snapshots. This provides a number of advantages:

  • Performance: AWS snapshots occur asynchronously resulting in shorter backup downtime for your instances
  • Durability: The underlying storage of AWS snapshots is in Amazon S3, which is stored redundantly and with high durability
  • Availability: AWS snapshots are available across an entire AWS region, and are available to restore even in the event of an outage affecting an entire Availabilty Zone (AZ)

To learn more about how to back up and restore a Bitbucket instance in AWS, see Using Bitbucket Server DIY Backup in AWS.

Administering Bitbucket in AWS

See Administering Bitbucket Server in AWS for information about performing administration tasks on a Bitbucket instance within AWS, including:

  • configuring variables when launching Bitbucket in AWS
  • maintaining, resizing, upgrading, migrating, and customizing your Bitbucket deployment in AWS
  • additional details about the components within the Bitbucket AMI

Securing Bitbucket within AWS

AWS is accessed over the public Internet, so it is important to apply appropriate security measures when running Bitbucket Server in AWS. See Best practices for securing Bitbucket in AWS for security guidance on a range of security topics, including Amazon Virtual Private Cloud (VPC), Security Groups, and SSL.

Last modified on Mar 1, 2023

Was this helpful?

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