diff --git a/docs/source/markdown/podman-system-migrate.1.md b/docs/source/markdown/podman-system-migrate.1.md index 96d5202f53..213bb7219b 100644 --- a/docs/source/markdown/podman-system-migrate.1.md +++ b/docs/source/markdown/podman-system-migrate.1.md @@ -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* diff --git a/libpod/runtime.go b/libpod/runtime.go index e314415025..178a6c2cec 100644 --- a/libpod/runtime.go +++ b/libpod/runtime.go @@ -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.") } }