oracular (1) podman-system-migrate.1.gz

Provided by: podman_5.0.3+ds1-5ubuntu1_amd64 bug

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


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


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)