KIWI::SYSTEM::STASH(8)

📦
version 11.1.1 · 9 versions
, in epel 10

💅 KIWI::SYSTEM::STASH(8) — the kiwi-ng system stash page, bestie edition 🎀

ok so this is a kiwi-ng manual page, section 8, and it's all about kiwi::system::stash — yes that's the full little name of it, iykyk 💖

✨ NAME ✨

kiwi::system::stash — makes a stash container out of an image root directory, no cap 🫶

🌸 SYNOPSIS 🌸

kiwi-ng [global options] service <command> [<args>]

kiwi-ng system stash --help
kiwi-ng system stash --root=<directory>
    [--tag=<name>]
    [--container-name=<name>]
kiwi-ng system stash --list

Like, that second block is the actual do the thing invocation, and the brackets mean those bits are optional. --help is your bestie when you're lost, and --list is the "what do I even have in here" mode 💅

🦋 DESCRIPTION 🦋

So. You've got a root directory. This command takes the contents of that root directory at the exact moment you call it and turns them into an OCI container — and that container is what everyone calls a stash. It's giving "snapshot but make it container" ✨

Where does it live? The stash gets stored down in /var/tmp/kiwi-stash, and then it's imported into your local container registry using podman. Very demure, very registry 🎀

And here's the fun part: if a stash with the same container name already exists, no drama — a new layer gets added to it. Stacking layers like it's a whole personality 💀

Oh and also — a stash can totally be used as the image root for the kiwi-ng system stackbuild command. If you want the full glow-up explanation of that, go read Building based on Containers. It's linked in spirit, go find it 🧚

💜 OPTIONS 💜

  • --root=<directory> — the path to the root directory. Usually this is the result of an earlier system prepare or build call, so like, it's already been through something 🌈
  • --tag=<name> — the tag name for the container. And if you don't say anything? It defaults to latest. Classic 💅
  • --container-name=<name> — the name of the container. If you skip it, it gets set to the image name of the stash by default. It names itself, main character energy fr 👑
  • --list — just list out the available stashes. That's it. That's the whole job 🍓

🔥 EXAMPLE 🔥

$ kiwi-ng system stash --root /tmp/mytest/build/image-root

look at her go 😭💖

⭐ AUTHOR ⭐

Marcus Schäfer — the icon behind all this 🫶

2020-2026, Marcus Schäfer — periodt, protect the copyright 💜

ok that's the whole page, you ate that reading it ngl 🌸 this was kiwi-ng system stash from the KIWI NG manual, version 11.1.1, dated Oct 06, 2026 — mwah, go stash something iconic 💅✨🎀

📦 where this page comes from