podman-system-migrate - Migrate existing containers to a new podman version

podmansystemmigrate migrates containers to the latest podman version.

       podmansystemmigrate 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 namespaces alive. This prevents any change
       to the /etc/subuid and /etc/subgid 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,
       podmansystemmigrate 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.

       April 2019, Originally compiled by Giuseppe Scrivano (gscrivan at redhat dot com)

                                                                                        podman-system-migrate(1)

       podman-system-migrate - Migrate existing containers to a new podman version

--new-runtime=runtime
       Set a new OCI runtime for all containers.  This can be used after a  system  upgrade  which  changes  the
       default  OCI  runtime  to  move  all  containers  to  the  new runtime.  There are no guarantees that the
       containers continue to work under the new  runtime,  as  some  runtimes  support  differing  options  and
       configurations.

podman(1), podman-system(1), usermod(8)

podmansystemmigrate [options]