Getting started with Bitbucket Server and AWS

Still need help?

The Atlassian Community is here for you.

Ask the community

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

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 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 Oct 16, 2019

Was this helpful?

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