DISTROBOX-STOP(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-STOP β€” the distrobox-stop(1) glow-up

okay bestie, welcome to the User Manual for distrobox stop / distrobox-stop, brought to you by Distrobox and your local over-caffeinated Unix gremlin πŸ’–


✨ NAME ✨

distrobox stop, and also distrobox-stop β€” same energy, two spellings, both iconic 🫢


🌸 DESCRIPTION 🌸

distrobox-stop stops a running distrobox. that's the whole job. it's giving girl who closes the tab when she's done 😌

here's the tea though: distroboxes do not shut themselves down when you exit out of them. they just... stay there. running. chilling. because that way, the next time you enter, it's instant β€” like, no waiting, no loading screen, just vibes. and this is how you actually stop them. periodt. πŸ”₯


πŸŽ€ SYNOPSIS πŸŽ€

distrobox stop

and here are all the flags, no cap, every single one πŸ‘‘

  • --all, -a β€” stop all the distroboxes. every last one. go off πŸ’€
  • --yes, -Y β€” non-interactive mode: it just stops, no asking, no "are you sure bestie?" β€” pure decisive main character energy ✨
  • --help, -h β€” show this message (hi, you're looking at the vibe πŸ’…)
  • --root, -r β€” launch podman/docker/lilipod with root privileges. important note: if you need root, this is the preferred way over "sudo distrobox" 🚨 (and also: if you gotta use a program other than sudo to get root privileges, you specify it through the DBX_SUDO_PROGRAM env variable, or the distrobox_sudo_program config variable. iykyk)
  • --verbose, -v β€” show more verbosity. it will simply say more words at you πŸ—£οΈ
  • --version, -V β€” show version πŸ“Œ

πŸ¦‹ EXAMPLES πŸ¦‹

look at her go πŸ₯Ή

distrobox-stop container-name1 container-name2
distrobox-stop container-name
distrobox-stop --all

and yes, you can also use environment variables to specify the container manager and the name:

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

literally one line, zero drama, slay 🌈


🧚 ENVIRONMENT VARIABLES 🧚

the little config girlies that whisper to your command before it even runs:

  • DBX_CONTAINER_MANAGER
  • DBX_CONTAINER_NAME
  • DBX_NON_INTERACTIVE
  • DBX_SUDO_PROGRAM

🌟 reminder bestie: a distrobox that's still running is not a bug, it's a speed feature. stop it on purpose, with distrobox-stop, and only when you actually mean it πŸ’–

mwah, that's the whole page 🫢 this came from Distrobox, dated Mar 2026, filed under DISTROBOX-STOP(1) in the manual. go stop something, queen πŸ‘‘βœ¨