DISTROBOX-LIST(1)

✨ NAME ✨

okay so this is distrobox list — aka distrobox-list — your lil' bestie from the Distrobox user manual, and she's here to show you every distrobox you've got kicking around 💖

---

🌸 DESCRIPTION 🌸

distrobox-list lists available distroboxes. That's it, that's the whole job, and she does it flawlessly 💅

The way she works: she detects them, and then she lists them separately from the rest of normal containers. So your regular containers don't get to crash the party — this list is distroboxes only, no gatecrashers, no cap 🫶

---

🎀 SYNOPSIS 🎀

distrobox list

And here's the whole flag squad, one by one, no skipping, periodt ✨

• --help, -h — show this message. She just tells you how she works. Iconic of her tbh.
• --no-color — disable color formatting. For when you want your terminal to be lowkey monochrome 🌈➡️⬜
• --root, -r — launch podman/docker/lilipod with root privileges. Note that if you need root this is the preferred way over sudo distrobox (note: if using a program other than sudo for root privileges is necessary, specify it through the DBX_SUDO_PROGRAM env variable, or distrobox_sudo_program config variable). So like, do it this way, bestie, don't rawdog it with sudo distrobox 🙈
• --verbose, -v — show more verbosity. She will simply not stop yapping. Love that for her.
• --version, -V — show version. Vibe check on which Distrobox you're running 👑

---

💖 EXAMPLES 💖

Look at her go:

distrobox-list

You can also use environment variables to specify container manager 🦋

DBX_CONTAINER_MANAGER="docker" distrobox-list

---

🧚 ENVIRONMENT VARIABLES 🧚

These are the little behind-the-scenes gremlins that change how she behaves:

• DBX_CONTAINER_MANAGER — tells her which container manager to use
• DBX_SUDO_PROGRAM — tells her which program to use for root privileges
• [IMAGE: image] image

---

and that's the whole page, bestie, you ate that 💅✨

Written by Distrobox, from Mar 2026, and yes this is DISTROBOX-LIST(1) — mwah, go forth and list your distroboxes 🎀💜