lxc-checkpoint(1)

lxc-checkpoint1

Checkpoint a container

Usage

lxc-checkpoint -n name -D PATH [-r] [-s] [-v] [-d] [-F]

Overview

lxc-checkpoint checkpoints and restores containers.

Options

FC-r, --restoreF[0]

Restore the checkpoint for the container, instead of dumping it. This option is incompatible with FC-sF[0].

FC-D F[0]PATHFC, --checkpoint-dir=F[0]PATH

The directory to dump the checkpoint metadata.

FC-s, --stopF[0]

Optionally stop the container after dumping. This option is incompatible with FC-rF[0].

FC-v, --verboseF[0]

Enable verbose criu logging.

FC-d, --daemonF[0]

Restore the container in the background (this is the default). Only available when providing FC-rF[0].

FC-F, --foregroundF[0]

Restore the container in the foreground. Only available when providing FC-rF[0].

Options

These options are common to most of lxc commands.

FC-?, -h, --helpF[0]

Print a longer usage message than normal.

FC--usageF[0]

Give the usage message

FC-q, --quietF[0]

mute on

FC-P, --lxcpath=F[0]PATH

Use an alternate container path. The default is /var/lib/lxc.

FC-o, --logfile=F[0]FILE

Output to an alternate log FILE. The default is no log.

FC-l, --logpriority=F[0]LEVEL

Set log priority to LEVEL. The default log priority is FCERRORF[0]. Possible values are : FCFATALF[0], FCALERTF[0], FCCRITF[0], FCWARNF[0], FCERRORF[0], FCNOTICEF[0], FCINFOF[0], FCDEBUGF[0], FCTRACEF[0].

Note that this option is setting the priority of the events log in the alternate log file. It do not have effect on the ERROR events log on stderr.

FC-n, --name=F[0]NAME

Use container identifier NAME. The container identifier format is an alphanumeric string.

FC--rcfile=F[0]FILE

Specify the configuration file to configure the virtualization and isolation functionalities for the container.

This configuration file if present will be used even if there is already a configuration file present in the previously created container (via lxc-create).

FC--versionF[0]

Show the version number.

Examples

lxc-checkpoint -n foo -D /tmp/checkpoint

Checkpoint the container foo into the directory /tmp/checkpoint.

lxc-checkpoint -r -n foo -D /tmp/checkpoint

Restore the checkpoint from the directory /tmp/checkpoint.

Releases

7 releases since Debian 7 (Wheezy); the text changed 6 times.

  1. 7
  2. 9
  3. 10
  4. 11
  5. 12
  6. 13
  7. Arch

--help until Debian 7 (Wheezy); --kill until Debian 7 (Wheezy); --logfile until Debian 7 (Wheezy); --logpriority until Debian 7 (Wheezy); --name until Debian 7 (Wheezy); --pause until Debian 7 (Wheezy); --quiet until Debian 7 (Wheezy); --statefd until Debian 7 (Wheezy); --statefile until Debian 7 (Wheezy); --usage until Debian 7 (Wheezy); -? until Debian 7 (Wheezy); -S until Debian 7 (Wheezy); -d until Debian 7 (Wheezy); -h until Debian 7 (Wheezy); -k until Debian 7 (Wheezy); -l until Debian 7 (Wheezy); -n until Debian 7 (Wheezy); -o until Debian 7 (Wheezy); -p until Debian 7 (Wheezy); -q until Debian 7 (Wheezy).

From lxc 1:7.0.0-2 in Arch Linux 2026-11-01. Parsed by carta from the page's man source.