Upgrading Sourcegraph

Upgrading to 3.0.1+

Read our migration guide for 2.x and 3.0.0.

For single-node deployments (sourcegraph/server)

A new version of Sourcegraph is released every month (with patch releases in between, released as needed). Check the Sourcegraph blog or the site admin updates page to learn about updates.

To update, just use the newer sourcegraph/server:N.N.N Docker image (where N.N.N is the version number) in place of the older one, using the same Docker volumes. Your server’s data will be migrated automatically if needed.

You can always find the version number of the latest release at docs.sourcegraph.com in the docker run command’s image tag.

  • As a precaution, before updating, we recommend backing up the contents of the Docker volumes used by Sourcegraph.
  • If you need zero-downtime updates, use the Kubernetes cluster deployment option.
  • There is currently no automated way to downgrade to an older version after you have updated. Contact support for help.

For Kubernetes cluster deployments

See “Updating Sourcegraph” in the Kubernetes cluster administrator guide.