distrobox-list

List all Distrobox containers

$ distrobox-list

$ distrobox-list [[-v|--verbose]]

distrobox list [OPTIONS]

-h, --help
    Show the help message and exit.

-v, --version
    Print the version string.

--dry-run
    Don't print anything, just check if the command succeeds.

--images
    Also list the images used by the distroboxes.

--containers
    List only the container names, not the distrobox names.

--name-only
    List only the distrobox names.

-V, --verbose
    Print verbose output.

--root
    Use a rootful frontend.

Distrobox enables running any Linux distro inside containers on your host, using Podman or Docker backends. The distrobox list command (also invoked as distrobox-list) displays all created distroboxes in a readable table format.

Default output shows columns for: Name (distrobox alias), Image (base container image), Created (timestamp), and Status (running/stopped). This overview aids in managing isolated environments for development, testing, or running apps from different distros without host pollution.

Customize with flags for images, containers only, names only, or verbose details. Supports rootful mode for privileged ops. Essential for users juggling multiple Linux ecosystems seamlessly.

Integrates with host package managers; exports apps to desktop menus. No root needed by default, preserving user namespaces.

Requires Podman or Docker installed and running. Output depends on backend; rootful mode needs sudo privileges. No filtering by status or image by default.

distrobox list
Shows table: Name | Image | Created | Status.

distrobox list --name-only
Outputs just names, one per line.

distrobox list --images --verbose
Includes image details and extra info.

Distrobox developed by Luca Wehr (89luca89) since 2021, initially for Fedora Silverblue. List command introduced in v1.0; enhanced in v1.4+ for better image/container separation and verbose output.

distrobox-create(1), distrobox-enter(1), distrobox-stop(1), podman(1), docker(1)