This tutorial shows you how to deploy Sourcegraph to a single node running on DigitalOcean.
If you’re just starting out, we recommend installing Sourcegraph locally. It takes only a few minutes and lets you try out all of the features. If you need scalability and high-availability beyond what a single-server deployment can offer, use the Kubernetes cluster deployment option.
Create a new Digital Ocean Droplet. Set the operating system to be Ubuntu 18.04. For droplet size, we recommend at least 4GB RAM and 2 CPU, but you may need more depending on team size and number of repositories. We recommend you set up SSH access (Authentication > SSH keys) for convenient access to the droplet.
SSH into the droplet, and install Docker:
snap install docker
Run the Sourcegraph Docker image as a daemon:
docker run -d --publish 80:7080 --publish 443:7443 --restart unless-stopped --volume /root/.sourcegraph/config:/etc/sourcegraph --volume /root/.sourcegraph/data:/var/opt/sourcegraph sourcegraph/server:3.12.0
Navigate to the droplet’s IP address to finish initializing Sourcegraph. If you have configured a
DNS entry for the IP, configure
externalURL to reflect that.
After initial setup, we recommend you do the following:
443via Cloud Firewalls.
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 -d ... sourcegraph/server:X.Y.Z