mirror/podman
1
0
Fork 0
mirror of https://github.com/containers/podman.git synced 2026-07-10 15:25:00 -04:00
Code Issues Packages Projects Releases Wiki Activity

Merge pull request #28237 from Luap99/5.8-migrate-docs

Browse Source 
[v5.8] Updating migration doc and warning with more details
This commit is contained in:
Matt Heon
2026-03-10 15:49:13 -04:00
committed by GitHub
parent 241a5b9e66 cf0019e3ed
commit 3bd2b272b2
2 changed files with 5 additions and 3 deletions
Download Patch File Download Diff File Expand all files Collapse all files

6
docs/source/markdown/podman-system-migrate.1.md
View File

@@ -31,9 +31,11 @@ newly configured mappings.
Migrate from the legacy BoltDB database to SQLite.
Support for BoltDB will be removed in Podman 6.0.
Podman will display a warning if this migration is necessary.
To ensure complete migration, all other Podman commands should be shut down before database migration.
To ensure complete migration, all other Podman commands must be shut down before database migration.
In particular, systemd-activated services like **podman system service** and Quadlets should be manually stopped prior to migration.
The legacy database will not be removed, so no data loss should occur even on failure.
If you are unsure please reboot instead and run any podman command afterwards which will trigger the migration
automatically as we can ensure there that no other parallel commands can interfere with the database.
The legacy database will not be removed, just renamed, so no permanent data loss should occur even on failure.
#### **--new-runtime**=*runtime*

2
libpod/runtime.go
View File

@@ -670,7 +670,7 @@ func makeRuntime(ctx context.Context, runtime *Runtime) (retErr error) {
} else if os.Getenv("SUPPRESS_BOLTDB_WARNING") == "" && os.Getenv("CI_DESIRED_DATABASE") != "boltdb" {
// Only warn about the database if we're not refreshing the state.
// Refresh will attempt an automatic migration.
logrus.Warnf("The deprecated BoltDB database driver is in use. This driver will be removed in the upcoming Podman 6.0 release in mid 2026. It is advised that you migrate to SQLite to avoid issues when this occurs using the `podman system migrate --migrate-db` command. Set SUPPRESS_BOLTDB_WARNING environment variable to remove this message.")
logrus.Warnf("The deprecated BoltDB database driver is in use. This driver will be removed in the upcoming Podman 6.0 release in mid 2026. It is advised that you migrate to SQLite to avoid issues when this occurs by rebooting and running podman again or using the `podman system migrate --migrate-db` command. IMPORTANT, only use that command when you can ensure they will be no parallel podman processes running, if you are unsure do the reboot. Set SUPPRESS_BOLTDB_WARNING environment variable to remove this message.")
}
}