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.
Open your DigitalOcean dashboard to create a new droplet
Choose an image - Select the One-click apps tab and then choose Docker
Choose a size - We recommend at least 4GB RAM and 2 CPU, more depending on team size and number of repositories/languages enabled.
Select additional options - Check "User data" and paste in the following:
#cloud-config repo_update: true repo_upgrade: all runcmd: - mkdir -p /root/.sourcegraph/config - mkdir -p /root/.sourcegraph/data - [ sh, -c, 'docker run -d --publish 80:7080 --publish 443:7443 --publish 2633:2633 --restart unless-stopped --volume /root/.sourcegraph/config:/etc/sourcegraph --volume /root/.sourcegraph/data:/var/opt/sourcegraph sourcegraph/server:3.10.1' ]
Launch your instance, then navigate to its IP address.
If you have configured a DNS entry for the IP, configure externalURL
to reflect that. (Note: externalURL
was called appURL
in Sourcegraph 2.13 and earlier.)
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