This tutorial shows you how to deploy Sourcegraph to a single EC2 instance on AWS.
Click Launch Instance from your EC2 dashboard.
Select the Amazon Linux 2 AMI (HVM), SSD Volume Type.
Select an appropriate instance size (we recommend t2.medium
or t2.large
, depending on team size and number of repositories/languages enabled), then Next: Configure Instance Details
Ensure the Auto-assign Public IP option is "Enable". This ensures your instance is accessible to the Internet.
Add the following user data (as text) in the Advanced Details section:
#cloud-config repo_update: true repo_upgrade: all runcmd: # Create the directory structure for Sourcegraph data - mkdir -p /home/ec2-user/.sourcegraph/config - mkdir -p /home/ec2-user/.sourcegraph/data # Install, configure, and enable Docker - yum update -y - amazon-linux-extras install docker - systemctl enable --now --no-block docker - sed -i -e 's/1024/10240/g' /etc/sysconfig/docker - sed -i -e 's/4096/40960/g' /etc/sysconfig/docker - usermod -a -G docker ec2-user # Install and run Sourcegraph. Restart the container upon subsequent reboots - [ sh, -c, 'docker run -d --publish 80:7080 --publish 443:7080 --publish 127.0.0.1:3370:3370 --restart unless-stopped --volume /home/ec2-user/.sourcegraph/config:/etc/sourcegraph --volume /home/ec2-user/.sourcegraph/data:/var/opt/sourcegraph sourcegraph/server:3.17.3' ]
Select Next: ... until you get to the Configure Security Group page. Then add the following rules:
80
, source 0.0.0.0/0, ::/0
443
, source 0.0.0.0/0, ::/0
Launch your instance, then navigate to its public IP in your browser. (This can be found by navigating to the instance page on EC2 and looking in the "Description" panel for the "IPv4 Public IP" value.) You may have to wait a minute or two for the instance to finish initializing before Sourcegraph becomes accessible. You can monitor the status by SSHing into the EC2 instance and viewing the logs:
docker logs $(docker ps | grep sourcegraph/server | awk '{ print $1 }')
If you have configured a domain name to point to the IP, configure externalURL
to reflect that.
To update to the most recent version of Sourcegraph (X.Y.Z), SSH into your instance and run the following:
docker ps # get the $CONTAINER_ID of the running sourcegraph/server container docker rm -f $CONTAINER_ID docker run docker run -d --publish 80:7080 --publish 443:7080 --restart unless-stopped --volume /home/ec2-user/.sourcegraph/config:/etc/sourcegraph --volume /home/ec2-user/.sourcegraph/data:/var/opt/sourcegraph sourcegraph/server:X.Y.Z
The Docker container has its own internal PostgreSQL and Redis databases. To preserve this data when you kill and recreate the container, you can use external databases for persistence, such as AWS RDS for PostgreSQL and Amazon ElastiCache.