DEBSPAWN-CREATE(1)

💖 debspawn-create — the glow-up era of container images 💖

okay bestie, welcome to debspawn-create(1), the manual page for debspawn create. yes it's a real manpage, yes i gave it a makeover, and no, i did not drop a single flag. periodt. ✨

---

🌸 NAME 🌸

debspawn-create — create new container images 🎀

---

✨ SYNOPSIS ✨

debspawn create [-h|--help] [--variant] [-a|--arch] [--suite] [--mirror]
                [--components] [--base-suite] [--extra-suites]
                [--extra-sourceslist-lines] [--allow-recommends]
                [--extra-packages] [--with-init] {NAME}

---

🦋 DESCRIPTION 🦋

so what this does is: it creates a new base image for a suite that debootstrap(1) or mmdebstrap(1) already knows about. think of it as building the little home base 🏠 before the main character moment happens.

that image will later get used to spawn ephemeral containers — temporary little pop-up studios 💅 — where packages can be built. gone when you're done, no mess, no drama.

and here's the cute little detail: if mmdebstrap is installed on your system, it will be preferred over debootstrap — unless a specific bootstrap tool is set in the global configuration. so like, the system has a favourite. iykyk. 👑

---

🧚 EXAMPLES 🧚

you can easily create images for any suite that has a script in debootstrap. no cap. for example, to create a Debian Unstable image for your current machine architecture, you can use:

$ debspawn create unstable

and here's a more advanced one, for building on Ubuntu 18.10 on the x86 architecture:

$ debspawn create --arch=i386 cosmic

okay so important lore 📖: the suite name is inferred from the container image name given as the positional parameter. if it can not be inferred, you will need to pass the --suite parameter with the primary suite name for this image. and heads up bestie — if a --base-suite is passed and no --suite is set, the image name will automatically be assumed to be for an overlay suite, which may not always be the desired result. so like, watch out, it's giving assumptions. 😭

---

👑 OPTIONS 👑

• NAME — the name of the container image to create (usually the name of the suite). it's the whole vibe, name it well. 🌈
• -h|--help — print brief help information about available commands. your little cheat sheet 🫶
• --variant — set the bootstrap script variant (use none to select no variant).
• -a|--arch — the architecture of the container.
• --suite — explicitly set a suite name (instead of having it derived from the container name).
• --mirror — set a specific mirror to bootstrap from.
• --components — a comma-separated list of archive components to enable in the newly created image.
• --base-suite — a full suite that forms the base of the selected partial suite (e.g. for -updates and -backports).
• --extra-suites — space-separated list of additional suites that should also be added to the sources.list file.
• --extra-sourceslist-lines — lines that should be added to the build environments source.list verbatim. separate lines by linebreaks.
• --allow-recommends — do not disable APT installing "recommends"-type dependencies by default, and instead use the default behavior for full, normal system installations with "recommends" enabled.
• --extra-packages — a comma-separated list of additional packages to install into the image during bootstrap.
• --with-init — include an init system in this image, so it is bootable. main character energy 🚀

---

💜 SEE ALSO 💜

debspawn-build(1), debootstrap(1), systemd-nspawn(1).

---

🎀 AUTHOR 🎀

this manual page was written by Matthias Klumpp <mak@debian.org>.

---

💌 COPYRIGHT 💌

Copyright © 2018-2022 Matthias Klumpp

---

okay that's the whole thing, bestie. every flag, every example, every copyright line — all here, all intact, just with ✨vibes✨. go build something iconic. 💅

and a cute little sign-off for the footer, since you asked: this page lives under the name Debspawn, and it's page DEBSPAWN-CREATE(1) — the copyright up there covers 2018-2022, so you know this lore has been serving since then. 🦋💖