1podman-container-restore(1)()                    podman-container-restore(1)()
2
3
4

NAME

6       podman-container-restore  -  Restores  one  or  more  containers from a
7       checkpoint
8
9

SYNOPSIS

11       podman container restore [options] container ...
12
13

DESCRIPTION

15       Restores a container from a checkpoint. You may use  container  IDs  or
16       names as input.
17
18

OPTIONS

20       --keep, -k
21
22
23       Keep  all  temporary  log  and  statistics files created by CRIU during
24       checkpointing as well as restoring. These  files  are  not  deleted  if
25       restoring  fails  for  further  debugging.  If restoring succeeds these
26       files are theoretically not needed, but if these files are needed  Pod‐
27       man  can  keep the files for further analysis. This includes the check‐
28       point directory with all files created during checkpointing.  The  size
29       required  by the checkpoint directory is roughly the same as the amount
30       of memory required by the processes in the checkpointed container.
31
32
33       Without the -k, --keep option the checkpoint will be consumed and  can‐
34       not be used again.
35
36
37       --all, -a
38
39
40       Restore all checkpointed containers.
41
42
43       --latest, -l
44
45
46       Instead of providing the container name or ID, restore the last created
47       container.
48
49
50       The latest option is not supported on the remote client.
51
52
53       --tcp-established
54
55
56       Restore a container with established TCP connections. If the checkpoint
57       image  contains  established  TCP  connections, this option is required
58       during restore.  If the checkpoint image does not  contain  established
59       TCP  connections this option is ignored. Defaults to not restoring con‐
60       tainers with established TCP connections.
61
62
63       --import, -i
64
65
66       Import a checkpoint tar.gz file, which was exported by Podman. This can
67       be  used  to  import a checkpointed container from another host. Do not
68       specify a container argument when using this option.
69
70
71       --name, -n
72
73
74       This is only available in combination with --import, -i. If a container
75       is  restored  from a checkpoint tar.gz file it is possible to rename it
76       with --name, -n. This way it is possible to restore a container from  a
77       checkpoint multiple times with different names.
78
79
80       If the --name, -n option is used, Podman will not attempt to assign the
81       same IP address to the container it was using before  checkpointing  as
82       each  IP  address can only be used once and the restored container will
83       have another IP address. This also means that --name, -n cannot be used
84       in combination with --tcp-established.
85
86
87       --ignore-rootfs
88
89
90       This is only available in combination with --import, -i. If a container
91       is restored from a checkpoint tar.gz file it is possible that  it  also
92       contains  all root file-system changes. With --ignore-rootfs it is pos‐
93       sible to explicitly disable applying these root file-system changes  to
94       the restored container.
95
96
97       --ignore-static-ip
98
99
100       If  the  container  was  started  with --ip the restored container also
101       tries to use that IP address and restore fails if that  IP  address  is
102       already  in  use.  This can happen, if a container is restored multiple
103       times from an exported checkpoint with --name, -n.
104
105
106       Using --ignore-static-ip tells Podman to ignore the IP  address  if  it
107       was configured with --ip during container creation.
108
109

EXAMPLE

111       podman container restore mywebserver
112
113
114       podman container restore 860a4b23
115
116

SEE ALSO

118       podman(1), podman-container-checkpoint(1)
119
120

HISTORY

122       September  2018,  Originally compiled by Adrian Reber areber@redhat.com
123       ⟨mailto:areber@redhat.com⟩
124
125
126
127                                                 podman-container-restore(1)()