An excerpt from the repository, fetched Nov 13, 2026.
Read the project’s introduction
Distrobox
previous logo credits j4ckr3d
current logo credits David Lapshin
Use any Linux distribution inside your terminal. Enable both backward and forward
compatibility with software and freedom to use whatever distribution you’re more
comfortable with.
Distrobox uses podman, docker or
lilipod to create containers using the Linux distribution
of your choice.
The created container will be tightly integrated with the host, allowing sharing
of the HOME directory of the user, external storage, external USB devices and
graphical apps (X11/Wayland), and audio.
Documentation -
Matrix Room -
Telegram Group
WarningDocumentation on GitHub strictly refers to the code in the main branch. For the official documentation
Head over https://distrobox.it
Distrobox
What it does
See it in action
Why?
Aims
Security implications
Quick Start
Assemble Distrobox
Configure Distrobox
Installation
Building from source
Dependencies
Install Podman without root
Compatibility
Supported container managers
Host Distros
Install on the Steamdeck
Containers Distros
Usage
Outside the distrobox
distrobox-assemble
distrobox-create
distrobox-enter
distrobox-ephemeral
distrobox-generate-entry
distrobox-list
distrobox-rm
distrobox-stop
distrobox-upgrade
Inside the distrobox
distrobox-export
distrobox-host-exec
distrobox-init
Configure distrobox
Useful tips
Launch a distrobox from your applications list
Create a distrobox with a custom HOME directory
Mount additional volumes in a distrobox
Use a different shell than the host
Run the container with real root
Run Debian/Ubuntu container behind proxy
Using a command other than sudo to run a rootful container
Duplicate an existing distrobox
Export to the host
Execute commands on the host
Resolve "Error cannot open display: :0"
Enable SSH X-Forwarding when SSH-ing in a distrobox
Using init system inside a distrobox
Using Docker inside a Distrobox
Using Podman inside a Distrobox
Using LXC inside a Distrobox
Using Waydroid inside a Distrobox
Manual Installation
Automated Installation
Using host's Podman or Docker inside a Distrobox
Using distrobox as main cli
Using a different architecture
Using the GPU inside the container
Using nvidia-container-toolkit
Slow creation on podman and image size getting bigger with distrobox create
Container save and restore
Check used resources
Pre-installing additional package repositories
Apply resource limitation on the fly
Posts
Announcing the next generation of Distrobox
Distrobox Next architecture
Create a dedicated distrobox container
Execute a command on the Host
Install Podman in HOME
Install Lilipod in HOME
Install on Steamdeck
Integrate VSCode and Distrobox
Run Libvirt using distrobox
Run latest GNOME and KDE Plasma using distrobox
Featured Articles
Articles
Run Distrobox on Fedora Linux - Fedora Magazine
DistroBox – Run Any Linux Distribution Inside Linux Terminal - TecMint
Distrobox: Try Multiple Linux Distributions via the Terminal - It's FOSS
Distrobox - How to quickly deploy a Linux distribution with GUI applications via a container
Using Distrobox To Augment The Package Selection On Clear Linux - Phoronix
Benchmark: benefits of Clear Linux containers (distrobox) - Phoronix
Distrobox - A great item in the Linux toolbelt - phmurphy's blog
Distrobox: Run (pretty much) any Linux distro under almost any other - TheRegister
Day-to-day differences between Fedora Silverblue and Ubuntu - castrojo's blog
Distrobox is Awesome - Running Window Manager and Desktop environments using Distrobox
Japanese input on Clear Linux with Mozc via Ubuntu container with Distrobox
MID (MaXX Interactive Desktop) on Clear Linux via Ubuntu container with Distrobox
Running Other Linux Distros with Distrobox on Fedora Linux - bandithijo's blog
Talks and Videos
Linux App Summit 2022 - Distrobox: Run Any App On Any Distro - BoF
Opensource Summit 2022 - Distrobox: Run Any App On Any Distro
A "Box" Full of Tools and Distros - Dario Faggioli @ OpenSUSE Conference 2022
Podman Community Meeting October 4, 2022
Distrobox opens the Steam Deck to a whole new world (GUIDE) - GamingOnLinux
CERN - Containerization as a means of extending the lifetime of HDL development tools
How to Code with Distrobox on the Steam Deck
Why you should be running the MicroOS Desktop
Podcasts
What it does
Simply put it's a fancy wrapper around podman, docker, or lilipod to create and start
containers which are highly integrated with the hosts.
The distrobox environment is based on an OCI image.
This image is used to create a container that seamlessly integrates with the
rest of the operating system by providing access to the user's home directory,
the Wayland and X11 sockets, networking, removable devices (like USB sticks),
systemd journal, SSH agent, D-Bus,
ulimits, /dev and the udev database, etc...
It implements the same concepts introduced by https://github.com/containers/toolbox,
keeping integration and broad host compatibility as primary goals.
All the props go to them as they had the great idea to implement this stuff.
distrobox is shipped as a single binary providing the following subcommands:
distrobox assemble – create and destroy containers based on a config file
distrobox create – create a container
distrobox enter – enter a container
distrobox ephemeral – create a temporary container, destroy it when exiting the shell
distrobox list (alias: ls) – list containers created with distrobox
distrobox rm – delete a container created with distrobox
distrobox stop – stop a running container created with distrobox
distrobox upgrade – upgrade one or more containers created with distrobox at once
distrobox generate-entry – create an entry of a created container in the applications list
Plus three helpers that run inside the container:
distrobox-init – container entrypoint (not meant to be invoked manually)
distrobox-export – export apps and services from the container to the host
distrobox-host-exec – run commands/programs from t
Read the full README on GitHub