*CHECKPOINTCTL-BUILD*(1)

💅 CHECKPOINTCTL-BUILD — the checkpointctl manual, but make it cute

okay bestie, so this one lives in the CHECKPOINTCTL manual and it's literally called checkpointctl-build. it's the glow-up era of your checkpoint tar file 🦋

---

✨ NAME ✨

checkpointctl-build — create an OCI image from a checkpoint tar file 👑 like, we're turning a tar into a whole image, no biggie

---

🌸 SYNOPSIS 🌸

checkpointctl build [OPTION]... CHECKPOINT_PATH IMAGE_NAME

that's it. that's the whole vibe. OPTIONs go first (as many as you want, they're optional, they're options), then your CHECKPOINT_PATH, then your IMAGE_NAME, periodt 💅

---

🫶 DESCRIPTION 🫶

so what we're doing here is creating an OCI image from a container checkpoint archive — a tar file, if we're being specific — using buildah. yes, buildah. the whole thing is powered by buildah and it's iconic of it honestly.

here's the tea 🍵: the checkpoint metadata gets extracted from the archive, and then that metadata gets applied as OCI image annotations. why do we care? because that's how the container runtime — and look, it could be Podman, CRI-O, or containerd, the runtime of your choice, we don't gatekeep — can identify the image as a checkpoint. it's giving "this image knows what it is." main character energy for real 💖

---

🎀 OPTIONS 🎀

• -h, --help — show help for checkpointctl build. that's the one (1) option. she's lowkey doing everything she needs to do, ngl 🙈

---

⭐ EXAMPLES ⭐

build an OCI image from a checkpoint archive:

$ checkpointctl build checkpoint.tar quay.io/foo/bar:latest
$ buildah push quay.io/foo/bar:latest

see how the first line makes the image and the second line pushes it? ate. no crumbs. 🔥

---

🌈 SEE ALSO 🌈

• checkpointctl(1) — the main one, the mothership, go read her too 🧚

---

💜 AUTHOR 💜

The CRIU team 🫶 — legends, honestly, we stan

---

okay so that's the whole page, and before you go, the boring-but-required receipts: this was from the checkpointctl manual, dated 2026-10-19. mwah, go build something cute 💅✨