DEB2DOCKER(1)

🎀 DEB2DOCKER — bestie edition 💅

okay so you found deb2docker(1) and you're like "what is this" — let me hold your hand through it, no cap.

---

✨ NAME ✨

deb2docker — build a Docker image with the Debian packages you tell it to 🐳💖

---

🌸 SYNOPSIS 🌸

deb2docker [-hB][-c CMD][-f FROM][-n NAME][-o DIR][-p PRE_SCRIPT][-s
POST_SCRIPT] packages

---

🦋 DESCRIPTION 🦋

So deb2docker is literally a little script that takes a list of Debian packages as input and automatically generates a Docker container with those packages inside it. Iconic behaviour fr fr. 🫶

It also generates a whole set of freedesktop.org desktop launchers for you, based on the .desktop and icon files it finds in the packages. And on top of that, it makes a desktop launcher that starts the container in a Terminal. The way it just... does all that. 😭✨

This tool is giving two vibes at once: it's suited for deploying applications as containers, and also for testing Debian packages in a sandbox. Main character energy either way. 👑

---

💅 OPTIONS 💅

• -B — do NOT build the image (default is to build, bestie). A build script gets generated in the DIR target directory instead. 📝
• -c EXEC — the command to run in the container (defaults to /bin/bash). ✨
• -f FROM — which distribution is to be used (defaults to debian:stable). 🌈
• -h — show this help. simple as that, queen. 🙈
• -n NAME — name of the image (default is built from the package list). 🎀
• -o DIR — use the given directory DIR for the build (default is in /tmp). 📂
• -p PRE_SCRIPT — execute the given script PRE_SCRIPT before packages install. ⏮️
• -s POST_SCRIPT — execute the given script POST_SCRIPT after packages install. ⏭️
• packages — the package list can be any Debian package, as well as local .deb files. yes you read that right, local files too. 💀💖

---

🍓 FILES 🍓

here's everything it drops for you, no gatekeeping:

• DIR/README
• DIR/Dockerfile
• DIR/launchers/
• DIR/icons/
• DIR/build
• DIR/start

---

🧚 NOTES 🧚

okay so obviously you need Docker installed, and you need to be part of the docker group. not optional, bestie. 😌

• sudo apt install docker.io
• `sudo usermod -aG docker $USER``

⚠️ heads up: you may have to manually configure Docker to pass a proxy configuration. don't come for me, that's just how it is. 🙈

And these are the usual commands people typically use to handle Docker containers:

build  docker build –rm Dockerfile
run    docker run –rm -it NAME
clean  docker rmi NAME
clean ALL docker system prune -a

(i put the little labels next to them so it reads like the original, but the commands are exactly as written, promise 🤞)

---

🔥 EXAMPLES 🔥

Example one: create a Docker container with package x11-apps in directory /tmp/xeyes, and launch xeyes:

• deb2docker -o /tmp/xeyes x11-apps
• /tmp/xeyes/start xeyes

A Desktop launcher is created as /tmp/xeyes/launchers/x11-apps-terminal.desktop ✨

Example two: create a Docker container with x11-apps and meshlab:

deb2docker x11-apps meshlab

Example three: create a Docker container making sure software channels are active:

• first write your pre script:

echo “sed -i `s/main/main contrib non-free/g' /etc/apt/sources.list” > pre.sh

• then run it:

deb2docker -p pre.sh x11-apps

---

👑 AUTHORS 👑

Emmanuel Farhi (emmanuel.farhi@synchrotron-soleil.fr) — shoutout to the legend who made this. 🫡💜

---

🌟 SEE ALSO 🌟

go read these next, bestie, they're all connected:

deb2apptainer(1), distrobox-create(1), distrobox-enter(1), docker(1), apptainer(1)

---

👑 AUTHORS (yes, again) 👑

Emmanuel Farhi.

---

and that's the whole page, babe — this was DEB2DOCKER(1), the February 2024 edition 💖 slay, you read the entire manual, go build something cute with it ✨🎀🦋