DISTROBOX-RM(1)

📦
version 1.8.2.5 · 6 versions
, in alpine 3.24, arch rolling, epel 10, epel 9, fedora 43, fedora 44, nixos 26.05, nixpkgs unstable, ubuntu stonking

💖 DISTROBOX-RM 💖

okay bestie, welcome to the DISTROBOX-RM(1) page — part of the Distrobox User Manual, and yes it's giving "spring cleaning but make it terminal" energy. this is the little tool that ✨ deletes ✨ your distroboxes. bye babe 💅

🌸 NAME 🌸

  • distrobox rm
  • distrobox-rm

(yeah it answers to both names, she contains multitudes 🫶)

🦋 DESCRIPTION 🦋

distrobox-rm delete one of the available distroboxes.

like. it removes a distrobox. that's the whole vibe. one distrobox, gone, poof, no takebacks 🎀

✨ SYNOPSIS ✨

distrobox rm

here come the flags, and you're gonna wanna read these fr fr, no skipping:

  • --all, -a — delete all distroboxes. every single one. the whole collection. 😭
  • --force, -f — force deletion. she's not asking permission, she's just doing it.
  • --rm-home — remove the mounted home if it differs from the host user's one. (keyword: if it differs — do not come for me, that's literally what it says 💀)
  • --root, -r — launch podman/docker/lilipod with root privileges. and okay important note: if you need root, this is the preferred way over "sudo distrobox". also note that 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. iykyk 👑
  • --help, -h — show this message
  • --verbose, -v — show more verbosity
  • --version, -V — show version
bestie warning: --all and --force are the "main character energy" flags. they will absolutely delete things. respect them. 🚨

🌈 EXAMPLES 🌈

the classic, deletin' one container:

distrobox-rm container-name [--force] [--all]

and you can also use environment variables to specify container manager and name, which is lowkey iconic:

DBX_CONTAINER_MANAGER="docker" DBX_CONTAINER_NAME=test-alpine distrobox-rm

see? you can just say which manager and which name up front and she gets it. obsessed. ⭐

🧚 ENVIRONMENT VARIABLES 🧚

the full roster, no notes:

  • DBX_CONTAINER_MANAGER
  • DBX_CONTAINER_NAME
  • DBX_NON_INTERACTIVE
  • DBX_SUDO_PROGRAM

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

source/version: Distrobox — dated Mar 2026 — manual page DISTROBOX-RM(1). go forth and clean up your containers responsibly, ily 🍓💜
📦 where this page comes from