podman-system-migrate(1) General Commands Manual podman-system-migrate(1)
NAME
podman-system-migrate - Migrate existing containers to a new podman ver-
sion
SYNOPSIS
podman system migrate [options]
DESCRIPTION
podman system migrate migrates containers to the latest podman version.
podman system migrate takes care of migrating existing containers to the
latest version of podman if any change is necessary.
"Rootless Podman uses a pause process to keep the unprivileged name-
spaces alive. This prevents any change to the /etc/subuid and /etc/sub-
gid files from being propagated to the rootless containers while the
pause process is running.
For these changes to be propagated, it is necessary to first stop all
running containers associated with the user and to also stop the pause
process and delete its pid file. Instead of doing it manually, podman
system migrate can be used to stop both the running containers and the
pause process. The /etc/subuid and /etc/subgid files can then be edited
or changed with usermod to recreate the user namespace with the newly
configured mappings.
OPTIONS
--new-runtime=runtime
Set a new OCI runtime for all containers. This can be used after a sys-
tem upgrade which changes the default OCI runtime to move all containers
to the new runtime. There are no guarantees that the containers con-
tinue to work under the new runtime, as some runtimes support differing
options and configurations.
SEE ALSO
podman(1), podman-system(1), usermod(8)
HISTORY
April 2019, Originally compiled by Giuseppe Scrivano (gscrivan at redhat
dot com)
podman-system-migrate(1)
Generated by dwww version 1.16 on Tue Dec 16 06:04:01 CET 2025.