KIWI::IMAGE::RESIZE(8)

💅 kiwi::image::resize — the glow-up page

ok so this is part of KIWI NG, and the manual page name is KIWI::IMAGE::RESIZE(8) — yes that's a mouthful, we don't say it out loud, we just vibe with it 🫶

✨ NAME ✨

kiwi::image::resize — bestie, it resizes disk images to a new geometry. that's the whole thing. that's the job. 💖

✨ SYNOPSIS ✨

here's how you actually call it:

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

kiwi-ng image resize --help
kiwi-ng image resize --target-dir=<directory> --size=<size>
    [--root=<directory>]

the --help one is your safe little intro, the second one is the real deal 🔥

✨ DESCRIPTION ✨

okay so picture this: you've got a disk-based image, right? and you want to resize it to a new disk geometry. that's literally what this does — slay. 💅

the extra space it gives you is free and not in use by the image. it's just sitting there, hanging out, unused, like a spare room nobody's decorated yet 🎀

but here's the cute part: the OEM boot code in KIWI NG ships with a resizing procedure that can actually make use of that additional free space. so the space doesn't just sit there forever being useless — the OEM boot code swoops in and puts it to work. icon behaviour tbh 👑

and for OEM image builds specifically? it is <highkey>advisable</highkey> to run the resizing operation. like, do it. don't skip it. it's giving self-care for your image ✨

✨ OPTIONS ✨

every single flag, no skips, no cap:

• --root=<directory> — the path to the root directory. but like, if you don't specify it? kiwi goes hunting for it — it searches for the root directory in build/image-root under the specified target directory. so it'll find it, it's just doing a lil scavenger hunt first 🔍💖
• --size=<size> — the new size of the image, bestie. and you've got options for how to say it: either a plain size in bytes, or you can spice it up with m for MB or g for GB. the example they give is 20g — see, lowercase g, no space, chefs kiss 🍓
• --target-dir=<directory> — the directory containing the kiwi build results. that's where the goodies live 📁✨

✨ AUTHOR ✨

Marcus Schäfer — the main character who wrote this. respect the icon 🌟

✨ COPYRIGHT ✨

2020-2026, Marcus Schäfer — yeah, that's the copyright line, keeping it exactly as it is, periodt.

---

and that's the whole page, bestie 🦋 so this version is 11.1.1 and it's dated Oct 06, 2026 — go forth and resize responsibly, iykyk 💜🎀