Distrobox — Use Any Linux Distribution Inside Your Terminal

Introduction

Distrobox wraps Podman or Docker to create Linux containers that are deeply integrated with your host system. Unlike traditional containers that isolate everything, Distrobox shares your home directory, Wayland/X11 display, audio, USB devices, and more. This lets you use packages from any Linux distribution as if they were natively installed on your machine.

What Distrobox Does

• Creates mutable containers from any OCI image (Ubuntu, Fedora, Arch, Alpine, and more)
• Shares the host home directory, display server, audio, and devices with the container
• Exports applications and binaries from the container to the host desktop menu and PATH
• Supports GPU passthrough for NVIDIA and AMD cards inside containers
• Works with both Podman (rootless) and Docker as the container backend

Architecture Overview

Distrobox is a set of POSIX shell scripts that orchestrate Podman or Docker. When you create a container, it pulls the requested OCI image and starts it with carefully crafted bind mounts and device mappings. An init system inside the container sets up user accounts, integrates with the host DBus and display server, and mounts host directories. The result is a container that behaves like a lightweight VM but starts in seconds and shares resources seamlessly with the host.

Self-Hosting & Configuration

• Install via the official install script or from your distribution's package repository
• Requires Podman (recommended for rootless) or Docker as the container runtime
• Configure default container settings in ~/.config/distrobox/distrobox.conf
• Use distrobox-assemble with a YAML manifest to define and recreate multiple containers
• Customize init hooks to run setup scripts when containers start

Key Features

• Near-native performance since containers share the host kernel
• GPU and hardware passthrough for development and creative workloads
• Application export makes containerized GUI apps appear as native host applications
• Works on immutable Linux distributions like Fedora Silverblue, SteamOS, and NixOS
• Ephemeral containers for testing packages without affecting the host

Comparison with Similar Tools

• Toolbx (Toolbox) — Fedora-focused, similar concept but less flexible with image choices and host integration
• WSL 2 — runs a full Linux kernel on Windows but is not available on native Linux systems
• Docker — general container runtime that isolates by default rather than integrating with the host
• Virtual machines — full OS isolation but much heavier resource usage and slower startup
• Nix shells — reproducible dev environments but limited to Nix-packaged software

FAQ

Q: Does Distrobox replace my host package manager? A: No. It supplements your host by giving you access to packages from other distributions without touching the host filesystem.

Q: Can I run GUI applications inside Distrobox? A: Yes. Display server, audio, and GPU access are shared with the host. You can export apps so they appear in your host desktop menu.

Q: Does it work on immutable distributions? A: Yes. Distrobox is popular on Fedora Silverblue, SteamOS, and NixOS where the root filesystem is read-only.

Q: What container runtime should I use? A: Podman is recommended for rootless operation. Docker works as well but typically requires root or a daemon.

Sources

• https://github.com/89luca89/distrobox
• https://distrobox.it/