KRAFT-PKG(1)

🎀 NAME 🎀

Hiii bestie, welcome to the KraftKit Manual entry (a.k.a. the KraftKit CLI(1) page, iykyk) for kraft-pkg — the tool that packages and distributes Unikraft unikernels and their dependencies. periodt 💅

✨ SYNOPSIS ✨

kraft pkg [FLAGS] [SUBCOMMAND|DIR]

🦋 DESCRIPTION 🦋

Okay so real talk: kraft-pkg is literally about packaging and distributing Unikraft unikernels and their dependencies. That's the whole vibe. 🫶

With kraft pkg you are able to turn output artifacts from kraft build into a distributable archive ready for deployment. And bestie, it gets better — at the same time, kraft pkg allows you to manage these archives: pulling, pushing, or adding them to a project. The way that's so versatile 😭✨

The default behaviour of kraft pkg is to package a project. Given no arguments, you will be guided through interactive mode — so if you're ever like "idk what to do", just run it bare and let it hold your hand 🧚💖

---

💅 OPTIONS 💅

Like, so many options, but every single one is iconic in its own way. Let's go 🔥

• -m, --arch="" — filter the creation of the package by architecture of known targets (x86_64/arm64/arm), slay 🎯
• -a, --args=[] — pass arguments that will be part of the running kernel's command line
• -M, --as="oci" — force the packaging despite possible conflicts (main character energy, it does what it wants 💀)
• -c, --compress[=false] — compress the initrd package (experimental, so like… handle with care bestie)
• --dbg[=false] — package the debuggable (symbolic) kernel image instead of the stripped image 🐛
• -e, --env=[] — set environment variables to be packed into the package
• --force-format[=false] — force the use of a packaging handler format
• -h, --help[=false] — help for pkg (always here for u 🫶)
• --kconfig-file="" — set a path to an extra KConfig file to be included as metadata
• --keep-file-owners[=false] — keep file owners (user:group) in the rootfs (false sets 'root:root')
• -k, --kernel="" — override the path to the unikernel image
• -K, --kraftfile="" — set an alternative path of the Kraftfile
• -l, --label=[] — set labels to be packed into the package (k=v)
• -n, --name="" — specify the name of the package
• --no-kconfig[=false] — do not include target .config as metadata
• --no-kernel[=false] — allow packaging without a kernel image
• --no-pull[=false] — do not pull package dependencies before packaging
• -o, --output="" — save the package at the following output
• -p, --plat="" — filter the creation of the package by platform of known targets (fc/qemu/xen/kraftcloud)
• -P, --push[=false] — push the package on if successfully packaged
• -R, --rom=[] — specify a path to an auxiliary ROM to include in the package
• --rom-type="cpio" — set the type of the format of the ROM (cpio/erofs)
• --rootfs="" — specify a path to use as root file system (can be volume or initramfs)
• --rootfs-type="cpio" — set the type of the format of the rootfs (cpio/erofs)
• -r, --runtime="" — set the runtime to use for the package
• --set-kconfig=[] — set KConfig values to be packed into the package (k=v)
• --strategy="overwrite" — when a package of the same name exists, use this strategy when applying targets.
• -t, --target="" — package a particular known target
• -w, --workdir="" — set an alternative working directory (default is cwd)

ngl the --compress one is marked experimental in the original, so bestie please don't be surprised if it's a little quirky 💀✨

---

🌈 EXAMPLES 🌈

Obsessed with a good example, so here's the one:

# Package a project as an OCI archive and embed the target's KConfig.
$ kraft pkg --as oci --name unikraft.org/nginx:latest

Ate, no crumbs. 🍓

💜 SEE ALSO 💜

Go give these other icons a lil visit, they're all linked:

kraft(1), kraft-pkg-export(1), kraft-pkg-info(1), kraft-pkg-list(1), kraft-pkg-pull(1), kraft-pkg-push(1), kraft-pkg-remove(1), kraft-pkg-source(1), kraft-pkg-unsource(1), kraft-pkg-update(1)

⭐ HISTORY ⭐

1-Jan-1980 — Auto generated by KraftKit. Vintage but make it cute 🎀

---

mwah 💋 that's the whole page bestie — brought to you by KraftKit Documentation, dated Jan 1980, and yes it's the KraftKit CLI(1) manual. byeee 🫶💖