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**
12
13

DESCRIPTION

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

OPTIONS

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

SYNOPSIS

50       podman system migrate
51
52

SEE ALSO

54       podman(1), libpod.conf(5), usermod(8)
55
56

HISTORY

58       April  2019, Originally compiled by Giuseppe Scrivano (gscrivan at red‐
59       hat dot com)
60
61
62
63                                                    podman-system-migrate(1)()
Impressum