This page lists the changes that are relevant for upgrading Sourcegraph on Docker Compose.
For upgrade procedures or general info about sourcegraph versioning see the links below:
v6.3 patch 1Attention: These notes may contain relevant information about the infrastructure update such as resource requirement changes or versions of depencies (Docker, Docker Compose, externalized databases).
If the notes indicate a patch release exists, target the highest one.
docker-compose.override.yaml
file.Customers running Sourcegraph versions prior to v6.2.2553 and using the Sourcegraph provided PostgreSQL containers may encounter PostgreSQL collation version mismatch warnings after upgrading to more recent Sourcegraph versions due to an underlying glibc version update.
When logging into the database via psql or similar tools you may see the following warning:
WARNING: database "sg" has a collation version mismatch DETAIL: The database was created using collation version 2.40, but the operating system provides version 2.41.
Mismatched collation versions can lead to database index corruption if left unchecked.
Affected Services
Only self-hosted customers using the Sourcegraph provided PostgreSQL container images are affected.
Self-hosted customers using external databases, such as AWS RDS, GCP CloudSQL, or another self-managed solution are NOT affected.
See our PostgreSQL Collation Version Mismatch Resolution notes for more details.
v6.0.0v5.10.1164
using migrator's upgrade
command. Or use autoupgrade by setting the environment variable SRC_AUTOUPGRADE_IGNORE_DRIFT=true
on the frontend
container.Notes:Warning: Admins are advised to upgrade directly to v5.10.1164 circumventing this release.
Warning: This release updates the database container images from Postgres 12 to Postgres 16, and begins using Wolfi based images. Customers are advised to take a database backup before upgrading! See our postgres 12 end of life notice!
Warning:
automatic
and migratorupgrade
command will not work for this release, please upgrade directly tov5.10.1164
, or to a 5.9 version and conduct a standard upgrade using migrator's defaultup
command!
postgres-12-alpine
and codeintel-db
respectively to postgresql-16
. The codeinsights-db
container has been renamed to postgresql-16-codeinsights
.5.10.0
. The new expected schema definition for Sourcegraph is based on postgres 16. The schema drift is the result of automatic changes made to the schema by pg_upgrade utils, and will not cause issues in the application.
SRC_AUTOUPGRADE_IGNORE_DRIFT=true
is set in the server container.v5.0.3
, v5.0.4
, v5.0.5
, and v5.0.6
to v5.1.5
are affected by an ordering error in the frontend
databases migration tree.v5.1.x
tag in this version, as such multiversion upgrades using this image version will fail to upgrade to versions in v5.1.x
.v5.1.x
tag in this version, as such multiversion upgrades using this image version will fail to upgrade to versions in v5.1.x
.v5.1.x
tag in this version, as such multiversion upgrades using this image version will fail to upgrade to versions in v5.1.x
.v5.1.x
tag in this version, as such multiversion upgrades using this image version will fail to upgrade to versions in v5.1.x
.This release introduces a background job that will convert all LSIF data into SCIP. This migration is irreversible and a rollback from this version may result in loss of precise code intelligence data. Please see the migration notes for more details.
v4.3 ➔ v4.4.1 Notes:upgrade
, and contains the following text: "frontend": failed to apply migration 1648115472
.
'add-log', '-db=frontend', '-version=1648115472'
.upgrade
the next run of upgrade will encounter drift, this drift should be disregarded by providing migrator with the --skip-drift-check
flag.v4.0.1
when fetching upstream from deploy-sourcegraph-docker
.jaeger
(deployed with the jaeger-all-in-one
image) has been removed in favor of an OpenTelemetry Collector DaemonSet + Deployment configuration. See Configure a tracing backendv3.43.2
when fetching upstream from deploy-sourcegraph-docker
.v3.42.2
when fetching upstream from deploy-sourcegraph-docker
.v3.41.0
when fetching upstream from deploy-sourcegraph-docker
.caddy
is upgraded to version 2.5.1 and contains a breaking change from version 2.5.0. Incoming X-Forwarded-*
headers will no longer be trusted automatically. In order to preserve existing product functionality, the Caddyfile was updated to trust all incoming X-Forwarded-*
headers. #828frontend
and codeintel-db
are now given 1 hour to begin accepting connections before Kubernetes restarts the containers. #4136v3.40.2
when fetching upstream from deploy-sourcegraph-docker
.cadvisor
now defaults to run in privileged
mode. This allows cadvisor
to collect out of memory events happening to containers which can be used to discover underprovisoned resources. #804Target the tag v3.39.1
when fetching upstream from deploy-sourcegraph-docker
.
v3.39.1
pgsql
, codeintel-db
, and codeinsights-db
container)
postgresql.conf
files sourcegraph/deploy-sourcegraph-docker#792.pgsql
and codeintel-db
from 2GB
to 4GB
. -codeinsights-db
container no longer uses TimescaleDB and is now based on the standard Postgres image sourcegraph/deploy-sourcegraph-docker#780. Metrics scraping is also enabled.Target the tag v3.38.1
when fetching upstream from deploy-sourcegraph-docker
.
v3.38.1
SRC_GIT_SERVERS
, SEARCHER_URL
, SYMBOLS_URL
, and INDEXED_SEARCH_SERVERS
are set for the worker process.v3.37.0
when fetching upstream from deploy-sourcegraph-docker
.migrator
) independently of the frontend container. Confirm the environment variables on this new container match your database settings.v3.36.0
when fetching upstream from deploy-sourcegraph-docker
.v3.35.1
when fetching upstream from deploy-sourcegraph-docker
.query-runner
service has been decommissioned in the 3.35 release and will be removed during the upgrade. To delete the query-runner
service, specify --remove-orphans
to your docker-compose
command.v3.34.0
when fetching upstream from deploy-sourcegraph-docker
.v3.33.0
when fetching upstream from deploy-sourcegraph-docker
.v3.32.0
when fetching upstream from deploy-sourcegraph-docker
.Notes:WARNING: This upgrade must originate from
v3.30.3
.
v3.31.2
when fetching upstream from deploy-sourcegraph-docker
.pgsql
) and codeintel (codeintel-db
) databases have switched to an alpine-based Docker image. Upon upgrading, Sourcegraph will need to re-index the entire database. All users that use our bundled (built-in) database instances must read through the 3.31 upgrade guide before upgrading.Notes:WARNING: If you have already upgraded to 3.30.0, 3.30.1, or 3.30.2 please follow this migration guide.
v3.30.3
when fetching upstream from deploy-sourcegraph-docker
.v3.29.0
when fetching upstream from deploy-sourcegraph-docker
.worker
service that runs a number of background jobs that were previously run in the frontend
service. See notes on deploying workers for additional details. Good initial values for CPU and memory resources allocated to this new service should match the frontend
service.v3.28.0
when fetching upstream from deploy-sourcegraph-docker
.redis-cache
and redis-store
have been increased by 1GB. See https://github.com/sourcegraph/deploy-sourcegraph-docker/pull/373 for more context.Notes:WARNING: Sourcegraph 3.27 now requires Postgres 12+.
v3.27.0
when fetching upstream from deploy-sourcegraph-docker
.v3.26.0
when fetching upstream from deploy-sourcegraph-docker
.v3.25.0
when fetching upstream from deploy-sourcegraph-docker
.1.15
introduced changes to SSL/TLS connection validation which requires certificates to include a SAN
. This field was not included in older certificates and clients relied on the CN
field. You might see an error like x509: certificate relies on legacy Common Name field
. We recommend that customers using Sourcegraph with an external database and and connecting to it using SSL/TLS check whether the certificate is up to date.
v3.24.0
when fetching upstream from deploy-sourcegraph-docker
.v3.23.0
when fetching upstream from deploy-sourcegraph-docker
.v3.22.0
when fetching upstream from deploy-sourcegraph-docker
.code intel bundle manager
. This service has been deprecated and all references to it have been removed.v3.21.1
when fetching upstream from deploy-sourcegraph-docker
.codeintel-db
. If you have configured Sourcegraph with an external database, then update the CODEINTEL_PG*
environment variables to point to a new external database as described in the external database documentation. Again, these must not point to the same database or the Sourcegraph instance will refuse to start.RetroSearch is an open source project built by @garambo | Open a GitHub Issue
Search and Browse the WWW like it's 1997 | Search results from DuckDuckGo
HTML:
3.2
| Encoding:
UTF-8
| Version:
0.7.4