Skip to content

Docker Compose backup and restore example: fix path #2160

New issue

Have a question about this project? Sign up for a free GitHub account to open an issue and contact its maintainers and the community.

Sign up for GitHub

By clicking “Sign up for GitHub”, you agree to our terms of service and privacy statement. We’ll occasionally send you account related emails.

Already on GitHub? Sign in to your account

Merged
marcleblanc2 merged 2 commits into from
Nov 13, 2026
Merged

Docker Compose backup and restore example: fix path #2160

Changes from all commits
Commits
Show all changes
2 commits
Select commit Hold shift + click to select a range
ae62a5a
Copy Docker Compose restore files into the database volumes
marcleblanc2 Nov 13, 2026
9c91514
Match the Kubernetes page's read-only note on the Compose page
marcleblanc2 Nov 13, 2026
File filter

Filter by extension

Filter by extension
Conversations
Failed to load comments.
Loading
Jump to
Jump to file
Failed to load files.
Loading
Diff view
Diff view
30 changes: 21 additions & 9 deletions docs/self-hosted/deploy/docker-compose/operations.mdx
View file
Open in desktop
Original file line number Diff line number Diff line change
Expand Up @@ -117,40 +117,52 @@ docker compose -f db-only-migrate.docker-compose.yaml up -d
4. Copy the database files into the containers

```bash
docker cp sourcegraph_db.out pgsql:/tmp/sourcegraph_db.out
docker cp codeintel_db.out codeintel-db:/tmp/codeintel_db.out
docker cp codeinsights_db.out codeinsights-db:/tmp/codeinsights_db.out
docker cp sourcegraph_db.out pgsql:/data/sourcegraph_db.out
docker cp codeintel_db.out codeintel-db:/data/codeintel_db.out
docker cp codeinsights_db.out \
codeinsights-db:/var/lib/postgresql/data/codeinsights_db.out
```

The database containers have a read-only root filesystem, so copy the files into the database volumes. Step 6 deletes them after the restore.
Comment thread
marcleblanc2 marked this conversation as resolved.
Resolved

5. Restore the databases

```bash
docker exec pgsql \
psql -v ON_ERROR_STOP=1 --username sg \
-f /tmp/sourcegraph_db.out postgres
-f /data/sourcegraph_db.out postgres

docker exec codeintel-db \
psql -v ON_ERROR_STOP=1 --username sg \
-f /tmp/codeintel_db.out postgres
-f /data/codeintel_db.out postgres

docker exec codeinsights-db \
psql -v ON_ERROR_STOP=1 --username postgres \
-f /tmp/codeinsights_db.out template1
-f /var/lib/postgresql/data/codeinsights_db.out template1
```

6. After all three restores succeed, delete the backup files from the containers

```bash
docker exec pgsql rm /data/sourcegraph_db.out
docker exec codeintel-db rm /data/codeintel_db.out
docker exec codeinsights-db \
rm /var/lib/postgresql/data/codeinsights_db.out
```

6. Start the remaining Sourcegraph services
7. Start the remaining Sourcegraph services

```bash
docker compose up -d --remove-orphans
```

7. Verify the deployment has started
8. Verify the deployment has started

```bash
docker compose ps
```

8. Browse to your Sourcegraph deployment, login and verify your existing configuration has been restored
9. Browse to your Sourcegraph deployment, login and verify your existing configuration has been restored

## Monitoring

Expand Down
Loading