CONTAINER-GET(1)

📦
this version · 5 versions
, in debian bookworm, ubuntu noble

✨ CONTAINER-GET(1) ✨

okay bestie, so this is a page from the General Commands Manual (that's the manual name, she's fancy like that) and it's all about container-get, part of the compute-tools situation. let's get into it 💅

🌸 NAME 🌸

container-get — download a container. that's it. that's the whole job. iconic behaviour honestly 🫶

🦋 SYNOPSIS 🦋

container get ['OPTIONS']
cnt g ['OPTIONS']

two ways to say the same thing, because we love options (literally, there are options) 💖

🎀 DESCRIPTION 🎀

the container get command downloads a container based on a script. yes, a script. the script does the heavy lifting, you just vibe and pick which one. ✨

📜 Scripts

here are the download scripts you can pick from, no cap:

  • curl: the basic script that builds a Debian based container, see container-create-curl(1).
  • default: this one is a symlink (if it exists) to a download script that gets used when you didn't specify any script at all. on a Debian based system you can manage it through update-alternatives(1), like so: sudo update-alternatives --config container_get-script. very main character energy of it 🧚

💅 OPTIONS 💅

the following container get options are available, and bestie there are a lot of them, so buckle up:

  • -n, --name='NAME' — specify the container name. name your baby, you've earned it 👑
  • -c, --capability='CAPABILITY' — specify capabilities to grant, see capabilities(7). giving it powers fr fr
  • -d, --drop-capability='DROP_CAPABILITY' — specify capabilities to drop, see capabilities(7). taking those powers away, not me being the villain 😭
  • -s, --script='SCRIPT' — specify the container build script. defaults to 'debootstrap'.
  • -v, --verbose — explain what is being done. she's a talker and honestly? we love that 🗣️
  • -b, --bind='DIRECTORY:DIRECTORY[:OPTIONS][;DIRECTORY:DIRECTORY[:OPTIONS]]' — specify container read-write bind mounts, see the systemd-nspawn(1) --bind option. note the wild nesting in there: OPTIONS are optional, and you can chain a whole second mount on with a ; separated chunk. look at her go 🌈
  • --bind-ro='DIRECTORY:DIRECTORY[:OPTIONS][;DIRECTORY:DIRECTORY[:OPTIONS]]' — specify container read-only bind mounts, see the systemd-nspawn(1) --bind-ro option. same shape, but read-only, she's off-limits 🔒
  • --cnt-overlay='DIRECTORY_LOWER:DIRECTORY_UPPER:DIRECTORY_WORK:DIRECTORY_MERGED[;DIRECTORY_UPPER:DIRECTORY_LOWER:DIRECTORY_WORK:DIRECTORY_MERGED]' — specify container overlay mounts, see Documentation/filesystems/overlayfs.txt. yes the second group in the brackets really does list DIRECTORY_UPPER before DIRECTORY_LOWER — that's what the page says, we don't make the rules, we just respect them 💀
  • --cnt.overlay-options='OPTION1,OPTION2[;OPTION3,OPTION4]' — specify container overlay mount options, see Documentation/filesystems/overlayfs.txt. commas within a group, semicolons between groups, keep up bestie 🍓
  • --cnt.start='OPTION1[,OPTION2,...]' — specify container start options, see container-start(1).

🔥 EXAMPLES 🔥

create an example.net container using the curl script:

sudo container get -n example.net -s curl

create an example.net container with the default download script and start it:

sudo container get,start -n example.net

see how get,start just glues them together? ate, no crumbs ⭐

💜 SEE ALSO 💜

🫶 HOMEPAGE 🫶

more information about compute-tools and the Open Infrastructure project can be found on the homepage: https://open-infrastructure.net ✨

💌 CONTACT 💌

bug reports, feature requests, help, patches, support and everything else are welcome on the Open Infrastructure Software Mailing List <software@lists.open-infrastructure.net>.

Debian specific bugs can also be reported in the Debian Bug Tracking System: https://bugs.debian.org.

👑 AUTHORS 👑

compute-tools were written by Daniel Baumann <daniel.baumann@open-infrastructure.net> and others. shoutout to the "and others", we see you 🫡

and that's the whole page bestie, every single flag accounted for, nothing skipped, nothing invented 💖

this cutie pie came to you from compute-tools by Open Infrastructure — stay slay, stay containerized 🦋💅

📦 where this page comes from