Skip to content

Podman 6: Automatic BoltDB to SQLite migration #28569

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

Open
mheon wants to merge 3 commits into
base: main
Choose a base branch
from
Open

Podman 6: Automatic BoltDB to SQLite migration #28569

Show file tree
Hide file tree
Changes from all commits
Commits
Show all changes
3 commits
Select commit Hold shift + click to select a range
ea65e0f
Re-add a minimal version of BoltDB for migrations
mheon Apr 22, 2026
8d396f6
Add migration code for BoltDB to SQLite
mheon Dec 2, 2025
840de3b
libpod: return full path in sqliteStatePath()
Luap99 Mar 9, 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
2 changes: 2 additions & 0 deletions cmd/podman/system/migrate.go
View file
Open in desktop
Original file line number Diff line number Diff line change
Expand Up @@ -44,6 +44,8 @@ func init() {
newRuntimeFlagName := "new-runtime"
flags.StringVar(&migrateOptions.NewRuntime, newRuntimeFlagName, "", "Specify a new runtime for all containers")
_ = migrateCommand.RegisterFlagCompletionFunc(newRuntimeFlagName, completion.AutocompleteNone)

flags.BoolVar(&migrateOptions.MigrateDB, "migrate-db", false, "Migrate database from BoltDB to SQLite")
}

func migrate(_ *cobra.Command, _ []string) error {
Expand Down
9 changes: 9 additions & 0 deletions docs/source/markdown/podman-system-migrate.1.md
View file
Open in desktop
Original file line number Diff line number Diff line change
Expand Up @@ -26,6 +26,15 @@ newly configured mappings.

## OPTIONS

#### **--migrate-db**

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.
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.

#### **--new-runtime**=*runtime*

Set a new OCI runtime for all containers.
Expand Down
2 changes: 1 addition & 1 deletion go.mod
View file
Open in desktop
Original file line number Diff line number Diff line change
Expand Up @@ -63,6 +63,7 @@ require (
github.com/stretchr/testify v1.11.1
github.com/vbauerster/mpb/v8 v8.12.0
github.com/vishvananda/netlink v1.3.1
go.etcd.io/bbolt v1.4.3
go.podman.io/buildah v1.42.1-0.20260421143840-0acb6b8cca85
go.podman.io/common v0.67.2-0.20260420103546-618304d6f83d
go.podman.io/image/v5 v5.39.3-0.20260420103546-618304d6f83d
Expand Down Expand Up @@ -170,7 +171,6 @@ require (
github.com/vbatts/tar-split v0.12.2 // indirect
github.com/vishvananda/netns v0.0.5 // indirect
github.com/yusufpapurcu/wmi v1.2.4 // indirect
go.etcd.io/bbolt v1.4.3 // indirect
go.opentelemetry.io/auto/sdk v1.2.1 // indirect
go.opentelemetry.io/contrib/instrumentation/net/http/otelhttp v0.67.0 // indirect
go.opentelemetry.io/otel v1.42.0 // indirect
Expand Down
Loading
Loading