github.com/containers/podman/v5@v5.1.0-rc1/docs/source/markdown/podman-system-migrate.1.md (about)

     1  % podman-system-migrate 1
     2  
     3  ## NAME
     4  podman\-system\-migrate - Migrate existing containers to a new podman version
     5  
     6  ## SYNOPSIS
     7  **podman system migrate** [*options*]
     8  
     9  ## DESCRIPTION
    10  **podman system migrate** migrates containers to the latest podman version.
    11  
    12  **podman system migrate** takes care of migrating existing containers to the latest version of podman if any change is necessary.
    13  
    14  "Rootless Podman uses a pause process to keep the unprivileged
    15  namespaces alive. This prevents any change to the `/etc/subuid` and
    16  `/etc/subgid` files from being propagated to the rootless containers
    17  while the pause process is running.
    18  
    19  For these changes to be propagated, it is necessary to first stop all
    20  running containers associated with the user and to also stop the pause
    21  process and delete its pid file.  Instead of doing it manually, `podman
    22  system migrate` can be used to stop both the running containers and the
    23  pause process. The `/etc/subuid` and `/etc/subgid` files can then be
    24  edited or changed with usermod to recreate the user namespace with the
    25  newly configured mappings.
    26  
    27  ## OPTIONS
    28  
    29  #### **--new-runtime**=*runtime*
    30  
    31  Set a new OCI runtime for all containers.
    32  This can be used after a system upgrade which changes the default OCI runtime to move all containers to the new runtime.
    33  There are no guarantees that the containers continue to work under the new runtime, as some runtimes support differing options and configurations.
    34  
    35  ## SEE ALSO
    36  **[podman(1)](podman.1.md)**, **[podman-system(1)](podman-system.1.md)**, **usermod(8)**
    37  
    38  ## HISTORY
    39  April 2019, Originally compiled by Giuseppe Scrivano (gscrivan at redhat dot com)