1podman-system-migrate(1)()                          podman-system-migrate(1)()
2
3
4

NAME

6       podman-system-migrate  -  Migrate  existing  containers to a new podman
7       version
8
9

SYNOPSIS

11       podman system migrate [options]
12
13

DESCRIPTION

15       podman system migrate migrates containers to the latest podman version.
16
17
18       podman system migrate takes care of migrating  existing  containers  to
19       the latest version of podman if any change is necessary.
20
21
22       "Rootless  Podman  uses  a pause process to keep the unprivileged name‐
23       spaces alive. This prevents any change to the /etc/subuid and /etc/sub‐
24       gid  files  from  being propagated to the rootless containers while the
25       pause process is running.
26
27
28       For these changes to be propagated, it is necessary to first  stop  all
29       running  containers associated with the user and to also stop the pause
30       process and delete its pid file.  Instead of doing it manually,  podman
31       system  migrate can be used to stop both the running containers and the
32       pause process. The /etc/subuid and /etc/subgid files can then be edited
33       or  changed  with usermod to recreate the user namespace with the newly
34       configured mappings.
35
36

OPTIONS

38   --new-runtime=runtime
39       Set a new OCI runtime for all containers.  This can  be  used  after  a
40       system  upgrade  which changes the default OCI runtime to move all con‐
41       tainers to the new runtime.  There are no guarantees that the  contain‐
42       ers  will continue to work under the new runtime, as some runtimes sup‐
43       port differing options and configurations.
44
45

SEE ALSO

47       podman(1), podman-system(1), usermod(8)
48
49

HISTORY

51       April 2019, Originally compiled by Giuseppe Scrivano (gscrivan at  red‐
52       hat dot com)
53
54
55
56                                                    podman-system-migrate(1)()