CONTAINER-GET-CURL(1)

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

✨ CONTAINER-GET-CURL 💅

okay so bestie, you're looking at container-get-curl from the General Commands Manual and honestly? it's giving download-girlie. let's get into it 🎀

🌸 NAME 🌸

container-get-curl — download a Debian based container by downloading a tarball over the network 🦋

🎀 SYNOPSIS 🎀

container get -s curl ['OPTIONS']

💖 DESCRIPTION 💖

The curl container download script uses curl(1) to download a tarball over the network to create a Debian based container. that's literally the whole job. she downloads. she tarballs. she serves 💅

Depending on the tarball, this script otherwise creates a pure Debian system with three modifications (yes, exactly three, no more no less):

  • hostname is set (container name) in /etc/hostname ✨
  • systemd machine-id is generated in /etc/machine-id ✨
  • root password is set (user specified or 16 random characters) ✨

🧚 Container images 🧚

compute-tools will download tarballs from a server expecting that the images are tarballs with either gzip, lzip, xz, or no compression. See container-images.sh as an example on how to create your own container images 👑

💅 OPTIONS 💅

The following script options are available:

  • -n, --name='NAME' — Specify container name. like, name your baby 🍼
  • -a, --architecture='ARCHITECTURE' — Specify container architecture.
  • --clean — Remove container tarball after successful download. she does NOT keep the receipt 🗑️
  • -p, --root-password='PASSWORD' — Specify the root password, defaults to a random 16 character password.
  • --server='SERVER' — Specify the image server to download from, defaults to https://get.open-infrastructure.net/system/container/debian.
  • --setup='SETUP' — Specify the setup image name to download, defaults to the value specified through --system using the setup.tar.${COMPRESSION} suffix (where ${COMPRESSION} is either lz, xz, or gz depending on compressor availability on the host system).
  • --system='SYSTEM' — Specify the system image name to download, defaults to debian-bookworm-current_${ARCHITECTURE}.system.tar.${COMPRESSION} (where ${ARCHITECTURE} is the host systems architecture and ${COMPRESSION} either lz, xz, or gz depending on compressor availability on the host system).

🌈 EXAMPLES 🌈

Download a Debian 12 (bookworm) based container with same architecture as the host system:

sudo container get -s curl -n bookworm.example.net

Download a Debian 12 (bookworm) based container with different architecture as the host system:

sudo container get -s curl -n bookworm-i386.example.net -- --system debian-bookworm-current_i386.system.tar.xz
bestie note: see that -- in the second one? that's how you sneak extra flags past the first script. iykyk 🔥

💜 FILES 💜

The following files are used:

  • /etc/compute-tools/config — Container configuration files.
  • /usr/share/compute-tools/get-scripts — Container download scripts.
  • /usr/share/doc/compute-tools — Container documentation.
  • /var/lib/machines — Container directory.
  • /var/cache/container — Container cache directory.

👑 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.

and that's the whole page, bestie 💖 this was Open Infrastructure's compute-tools manual, CONTAINER-GET-CURL(1), brought to you by the Open Infrastructure crew — go forth and download some containers, you absolute icon 🎀✨🦋

📦 where this page comes from