runc-checkpoint(8) System Manager's Manual runc-checkpoint(8)

# [NAME](#NAME)

**runc-checkpoint** - checkpoint a running container

# [SYNOPSIS](#SYNOPSIS)

**runc checkpoint** \[*option* ...] *container-id*

# [DESCRIPTION](#DESCRIPTION)

The **checkpoint** command saves the state of the running container instance with the help of [**criu**(8)](/man/enterprise-packages/runc-fips/criu.8) tool, to be restored later.

# [OPTIONS](#OPTIONS)

[**--image-path** *path*](#image_path)

Set path for saving criu image files. The default is *./checkpoint*.

[**--work-path** *path*](#work_path)

Set path for saving criu work files and logs. The default is to reuse the image files directory.

[**--parent-path** *path*](#parent_path)

Set path for previous criu image files, in pre-dump.

[**--leave-running**](#leave_running)

Leave the process running after checkpointing.

[**--tcp-established**](#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**](#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**](#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**](#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**](#shell_job)

Allow checkpoint/restore of shell jobs.

[**--lazy-pages**](#lazy_pages)

Use lazy migration mechanism. See criu --lazy-pages option ⟨https://criu.org/CLI/opt/--lazy-pages⟩.

[**--status-fd** *fd*](#status_fd)

Pass a file descriptor *fd* to **criu**. Once **lazy-pages** server is ready, **criu** writes **\\0** (a zero byte) to that *fd*. Used together with **--lazy-pages**.

[**--page-server** *IP-address*:*port*](#page_server)

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**](#file_locks)

Allow checkpoint/restore of file locks. See criu --file-locks option ⟨https://criu.org/CLI/opt/--file-locks⟩.

[**--pre-dump**](#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**.](#manage_cgroups_mode)

Cgroups mode. Default is **soft**. See criu --manage-cgroups option ⟨https://criu.org/CLI/opt/--manage-cgroups⟩.

[**--empty-ns** *namespace*](#empty_ns)

Checkpoint a *namespace*, but don't save its properties. See criu --empty-ns option ⟨https://criu.org/CLI/opt/--empty-ns⟩.

[**--auto-dedup**](#auto_dedup)

Enable auto deduplication of memory images. See criu --auto-dedup option ⟨https://criu.org/CLI/opt/--auto-dedup⟩.

# [SEE ALSO](#SEE_ALSO)

[**criu**(8)](/man/enterprise-packages/runc-fips/criu.8), [**runc-restore**(8)](/man/enterprise-packages/runc-fips/runc-restore.8), [**runc**(8)](/man/enterprise-packages/runc-fips/runc.8), [**criu**(8)](/man/enterprise-packages/runc-fips/criu.8).

---

Document: runc-checkpoint(8) from runc-fips 1.5.2-r2 (Chainguard OS)
Source: https://github.com/opencontainers/runc