lxc-checkpoint(1)

📦
version 7.0.0 · 17 versions
, in alpine 3.24

💖 lxc-checkpoint(1) — the bestie's guide to freezing ur container mid-vibe 💖

okay so this is the lxc-checkpoint(1) manual page, and honestly? it's giving "save your whole container's soul to a folder and bring it back later" energy. let's get into it ✨

🌸 NAME 🌸

lxc-checkpoint — checkpoint a container 🎀 (like, literally snapshot its whole self)

🦋 SYNOPSIS 🦋

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

✨ DESCRIPTION ✨

lxc-checkpoint checkpoints and restores containers. that's the whole vibe. dump it, bring it back, slay 💅

🔥 OPTIONS 🔥

  • -r, --restore — restores the checkpoint for the container instead of dumping it. so like, instead of saving, you're loading. this option is incompatible with -s — pick a lane bestie 🫶
  • -D PATH, --checkpoint-dir=PATH — the directory where the checkpoint metadata gets dumped. that's where all the goods live 📁
  • -s, --stop — optionally stop the container after dumping. this option is incompatible with -r — again, no mixing 🚫
  • -v, --verbose — enables verbose criu logging. if u wanna see everything, this is ur moment 👀
  • -d, --daemon — restores the container in the background (and yes, this is the default). only available when you provide -r 🌙
  • -F, --foreground — restores the container in the foreground. only available when you provide -r ☀️

💜 COMMON OPTIONS 💜

these ones are common to most of the lxc commands — so like, the shared delulu of the whole lxc family fr fr

  • -?, -h, --help — prints a longer usage message than normal 📖
  • --usage — gives the usage message
  • -q, --quiet — mute on 🔇
  • -P, --lxcpath=PATH — uses an alternate container path. the default is /var/lib/lxc 🏠
  • -o, --logfile=FILE — outputs to an alternate log FILE. the default is no log 📝
  • -l, --logpriority=LEVEL — sets log priority to LEVEL. the default log priority is ERROR. possible values are: FATAL, ALERT, CRIT, WARN, ERROR, NOTICE, INFO, DEBUG, TRACE
heads up bestie: this option sets the priority of the events log in the alternate log file. it does not have effect on the ERROR events log on stderr. iykyk 😌
  • -n, --name=NAME — uses container identifier NAME. the container identifier format is an alphanumeric string 🔤
  • --rcfile=FILE — specifies the configuration file to configure the virtualization and isolation functionalities for the container
if this configuration file is present, it will be used even if there's already a configuration file present in the previously created container (via lxc-create). so yeah, it overrides. periodt 💅
  • --version — shows the version number 🏷️

🍓 EXAMPLES 🍓

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

checkpoints the container foo into the directory /tmp/checkpoint 🎀

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

restores the checkpoint from the directory /tmp/checkpoint 🦋

🌈 SEE ALSO 🌈

lxc(7), lxc-create(1), lxc-copy(1), lxc-destroy(1), lxc-start(1), lxc-stop(1), lxc-execute(1), lxc-console(1), lxc-monitor(1), lxc-wait(1), lxc-cgroup(1), lxc-ls(1), lxc-info(1), lxc-freeze(1), lxc-unfreeze(1), lxc-attach(1), lxc.conf(5)

okay that's the whole page, no cap 💀 this edition of lxc-checkpoint(1) is dated 2026-05-01 and it's from the lxc-checkpoint(1) manual, so like... go forth and checkpoint responsibly, bestie 👑💖

📦 where this page comes from