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

EXAMPLE

118       podman container restore mywebserver
119
120
121       podman container restore 860a4b23
122
123
124       podman   container   restore   --import-previous  pre-checkpoint.tar.gz
125       --import checkpoint.tar.gz
126
127

SEE ALSO

129       podman(1), podman-container-checkpoint(1)
130
131

HISTORY

133       September 2018, Originally compiled by Adrian  Reber  areber@redhat.com
134       ⟨mailto:areber@redhat.com⟩
135
136
137
138                                                 podman-container-restore(1)()