Single-container Sourcegraph self-hosted upgrade notes

⚠️ SUNSET NOTICE: The single-container (sourcegraph/server) deployment mode has been removed in Sourcegraph 7.0.0. The sourcegraph/server Docker image is no longer published starting with 7.0.0. Customers must migrate to Docker Compose or Kubernetes before upgrading to 7.0.0.

This page lists the changes that are relevant for upgrading Sourcegraph on a single-node Sourcegraph instance.

For upgrade procedures or general info about sourcegraph versioning see the links below:

Attention: These notes may contain relevant information about the infrastructure update such as resource requirement changes or versions of dependencies (Docker, externalized databases).

If the notes indicate a patch release exists, target the highest one.

5.10.1164

This release resolves an issue in the v5.10.0 release which prevented multiversion upgrades from working. You may now target v5.10.1164 using migrator's upgrade command.

Note: For versions prior to 6.12.0, you could also use autoupgrade by setting the environment variable SRC_AUTOUPGRADE_IGNORE_DRIFT=true on the sourcegraph container. Autoupgrade has been removed in Sourcegraph 6.12.0 and later.

5.10.0

Notes:

Warning: Admins are advised to upgrade directly to v5.10.1164 circumventing this release.

Warning: In 5.10 the Sourcegraph database images are being updated from postgres 12 to postgres 16 to avoid postgres 12's end of life. This update will not yet be applied to Sourcegraph server's all in one database.

Warning: automatic and migrator upgrade command will not work for this release, please upgrade directly to v5.10.1164, or to a 5.9 version and conduct a standard upgrade using migrator's default up command!

What does this mean for admins?

During the postgres version upgrade pg_upgrade automatically makes some changes to the database schema.
The new canonical database schema is now based on postgres 16, the drift detection tool will report drift between the old and new database schema. This is expected and is a result of the postgres upgrade.
Admins should not run migrators suggested drift fixes until the database is upgraded.

5.1.0

Notes:

The Docker Single Container Deployment image has switched to a Wolfi-based container image. Upon upgrading, Sourcegraph will need to re-index the entire database.