runc-checkpoint8
Checkpoint a running container
Usage
runc checkpoint
[option ...]
container-id
Overview
The checkpoint command saves the state of the running container instance with the help of criu(8) tool, to be restored later.
Options
-
--image-path path -
Set path for saving criu image files. The default is ./checkpoint.
-
--work-path path -
Set path for saving criu work files and logs. The default is to reuse the image files directory.
-
--parent-path path -
Set path for previous criu image files, in pre-dump.
-
--leave-running -
Leave the process running after checkpointing.
-
--tcp-established -
Allow checkpoint/restore of established TCP connections. See criu --tcp-establised option ⟨https://criu.org/CLI/opt/--tcp-established⟩.
-
--tcp-skip-in-flight -
Skip in-flight TCP connections. See criu --skip-in-flight option ⟨https://criu.org/CLI/opt/--skip-in-flight⟩.
-
--link-remap -
Allow one to link unlinked files back when possible. See criu --link-remap option ⟨https://criu.org/CLI/opt/--link-remap⟩.
-
--ext-unix-sk -
Allow checkpoint/restore of external unix sockets. See criu --ext-unix-sk option ⟨https://criu.org/CLI/opt/--ext-unix-sk⟩.
-
--shell-job -
Allow checkpoint/restore of shell jobs.
-
--lazy-pages -
Use lazy migration mechanism. See criu --lazy-pages option ⟨https://criu.org/CLI/opt/--lazy-pages⟩.
-
--status-fd fd -
Pass a file descriptor fd to
criu. Oncelazy-pagesserver is ready,criuwrites\0(a zero byte) to that fd. Used together with--lazy-pages.
-
--page-server IP-address:port -
Start a page server at the specified IP-address and port. This is used together with criu lazy-pages. See criu lazy migration ⟨https://criu.org/Lazy_migration⟩.
-
--file-locks -
Allow checkpoint/restore of file locks. See criu --file-locks option ⟨https://criu.org/CLI/opt/--file-locks⟩.
-
--pre-dump -
Do a pre-dump, i.e. dump container's memory information only, leaving the container running. See criu iterative migration ⟨https://criu.org/Iterative_migration⟩.
-
--manage-cgroups-mode soft|full|strict|ignore. -
Cgroups mode. Default is
soft. See criu --manage-cgroups option ⟨https://criu.org/CLI/opt/--manage-cgroups⟩.
-
--empty-ns namespace -
Checkpoint a namespace, but don't save its properties. See criu --empty-ns option ⟨https://criu.org/CLI/opt/--empty-ns⟩.
-
--auto-dedup -
Enable auto deduplication of memory images. See criu --auto-dedup option ⟨https://criu.org/CLI/opt/--auto-dedup⟩.
Releases
6 releases since Debian 9 (Stretch); the text changed 5 times.
--auto-dedup since Debian 12 (Bookworm);
--empty-ns since Debian 12 (Bookworm);
--ext-unix-sk since Debian 12 (Bookworm);
--file-locks since Debian 12 (Bookworm);
--image-path since Debian 12 (Bookworm);
--lazy-pages since Debian 12 (Bookworm);
--leave-running since Debian 12 (Bookworm);
--link-remap since Arch Linux 2026-11-01;
--manage-cgroups-mode since Debian 12 (Bookworm);
--page-server since Debian 12 (Bookworm);
--parent-path since Debian 12 (Bookworm);
--pre-dump since Debian 12 (Bookworm);
--shell-job since Debian 12 (Bookworm);
--status-fd since Debian 12 (Bookworm);
--tcp-established since Debian 12 (Bookworm);
--tcp-skip-in-flight since Arch Linux 2026-11-01;
--work-path since Debian 12 (Bookworm).