Skip to content

Comments

revamp docker compose aws docs#1619

Draft
michaellzc wants to merge 1 commit intomainfrom
02-18-revamp_docker_compose_aws_docs
Draft

revamp docker compose aws docs#1619
michaellzc wants to merge 1 commit intomainfrom
02-18-revamp_docker_compose_aws_docs

Conversation

@michaellzc
Copy link
Member

No description provided.

@vercel
Copy link

vercel bot commented Feb 19, 2026

The latest updates on your projects. Learn more about Vercel for GitHub.

Project Deployment Actions Updated (UTC)
sourcegraph-docs Ready Ready Preview, Comment Feb 19, 2026 1:31am

Request Review

Copy link
Member Author

This stack of pull requests is managed by Graphite. Learn more about stacking.


### Amazon EC2

Follow the instructions in the [AWS documentation](https://docs.aws.amazon.com/AWSEC2/latest/UserGuide/EC2_GetStarted.html) to set up an EC2 instance with an EBS volume mounted. Ensure that you select an appropriate instance type based on your expected workload and resource requirements. We recommend using the Amazon Linux 2 AMI. Also, ensure that your EC2 instance is configured to accept incoming traffic from the internet on the standard ports (80 for HTTP and 443 for HTTPS) and that you have SSH access to the instance for management purposes.
Copy link
Contributor

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

A couple of thoughts on this section:

  1. Is there any specific reason we're recommending Amazon Linux 2? I could see customers reaching out to clarify whether other linux distros would be supported since we're explicitly calling this out.
  2. The last sentence assumes every deployment will be internet exposed. I'd suggest something along the lines of:

Configure inbound rules to allow HTTP/HTTPS (ports 80 and 443) only from the networks that should be able to reach the application (public internet for external deployments, or corporate/private ranges for internal deployments). Ensure you also have administrative access (SSH or Session Manager) for ongoing management of the application.


Follow the instructions in the [AWS documentation](https://docs.aws.amazon.com/AWSEC2/latest/UserGuide/EC2_GetStarted.html) to set up an EC2 instance with an EBS volume mounted. Ensure that you select an appropriate instance type based on your expected workload and resource requirements. We recommend using the Amazon Linux 2 AMI. Also, ensure that your EC2 instance is configured to accept incoming traffic from the internet on the standard ports (80 for HTTP and 443 for HTTPS) and that you have SSH access to the instance for management purposes.

You should also set up automatic snapshots for the EBS volume following [AWS documentation](https://docs.aws.amazon.com/ebs/latest/userguide/ebs-creating-snapshot.html) to ensure that your data is backed up regularly.
Copy link
Contributor

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

Should we consider adding a note that EBS backups should be scheduled in coordination with the RDS instance backups? I'm not sure how much this could complicate DR if the backups are taken at different times, but I assume this is a best practice.


## Deploying Sourcegraph

Follow the [installation steps for Docker Compose](/self-hosted/deploy/docker-compose#installation-steps) to complete the deployment of Sourcegraph on your AWS EC2 instance. During the configuration step, ensure to provide the necessary connection details for your RDS instance.
Copy link
Contributor

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

I'd suggest linking to our external postgres docs here for clarity since it requires a few clicks to navigate to that page from the docker-compose install instructions.

Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

None yet

Projects

None yet

Development

Successfully merging this pull request may close these issues.

2 participants