1podman-system-migrate(1)() podman-system-migrate(1)()
2
3
4
6 podman-system-migrate - Migrate existing containers to a new podman
7 version
8
9
11 ** podman system migrate**
12
13
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
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
50 podman system migrate
51
52
54 podman(1), libpod.conf(5), usermod(8)
55
56
58 April 2019, Originally compiled by Giuseppe Scrivano (gscrivan at red‐
59 hat dot com)
60
61
62
63 podman-system-migrate(1)()