Getting started with Bitbucket Server and AWS

Running Bitbucket Server in the Amazon Web Services (AWS) cloud can give you scalable computing capacity without the need to invest in hardware up front. To this end, Atlassian provides:

• an Amazon Machine Image (AMI) that you can launch in AWS as a "turnkey" deployment of Bitbucket Server, or use as the starting point for customizing your own more complex deployments,
• an Amazon CloudFormation template that automates the process of spinning up a Bitbucket Server instance in EC2, and
• tools and guidelines for backing up, restoring, sizing, and administering your Bitbucket Server instances in AWS.

 Running Bitbucket Data Center in AWS is not supported at this time.

Quick Start guide

Launching Bitbucket Server in AWS manually

For more precise control over the components enabled within the Atlassian Bitbucket Server AMI, including AWS-specific configuration, network and security settings, Launching Bitbucket Server in AWS manually describes how to launch the AMI by running the EC2 launch wizard.

Performance guidelines

To get the best performance out of your Bitbucket Server deployment in AWS, it's important not to under-provision your instance's CPU, memory, or I/O resources. We provide specific recommendations on choosing AWS EC2 and EBS settings for best performance when running Bitbucket Server in AWS. See Recommendations for running Bitbucket Server in AWS.

Backing up Bitbucket Server in AWS

Atlassian also provides Bitbucket Server DIY Backup utilities that back up and restore your Bitbucket Server instance in AWS 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 for 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 Server instance in AWS, see Using Bitbucket Server DIY Backup in AWS.

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

Securing Bitbucket Server within AWS

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