Install Sourcegraph with Docker on DigitalOcean

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.


Use the “Create Droplets” wizard

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.5.2' ]
    
  • 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.)


Update your Sourcegraph version

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