Files
distrobox/docs/usage/distrobox-list.md
T
Luca Di Maio 8d96cce479 docs: switch usage and man pages to v2 subcommand syntax
Rewrite distrobox-*.md to `distrobox <cmd>`, reconcile flag tables with
internal/cli, refresh README+useful_tips, regenerate man/man1/*.1.

Signed-off-by: Luca Di Maio <luca.dimaio1@gmail.com>
2026-06-25 13:39:47 +02:00

1.0 KiB

NAME

distrobox list

DESCRIPTION

distrobox list lists available distroboxes. It detects them and lists them separately from the rest of normal containers. The ls alias works too.

SYNOPSIS

distrobox list (alias: distrobox ls)

--help/-h:		show this message
--no-color:		disable color formatting
--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)
--verbose/-v:		show more verbosity
--version/-V:		show version

EXAMPLES

distrobox list

You can also use environment variables to specify container manager

DBX_CONTAINER_MANAGER="docker" distrobox list

ENVIRONMENT VARIABLES

DBX_CONTAINER_MANAGER
DBX_SUDO_PROGRAM

image