# Distrobox

> Another distribution's tooling on your machine, sharing your home directory

Category: Development environments (https://aiarabicdev.com/dev-environments)
Canonical page: https://aiarabicdev.com/dev-environments/distrobox
Tags: linux, containers, podman, immutable, self-hosted

Distrobox runs any Linux distribution's userspace in a container deliberately fused to your host rather than walled off from it: the same home directory, the same devices, the same display. It is the usual answer on an immutable system or a locked down work laptop. It is explicitly not a sandbox, and the project says so itself.

## Facts

- Licence: GPL-3.0-only
- Language: Shell
- Cost: Free and open source
- Self hostable: yes
- Added: 2026-09-12
- Last checked: 2026-09-12

## Links

- Website: https://distrobox.it
- Source: https://github.com/89luca89/distrobox
- Docs: https://distrobox.it/usage/usage/

## Integration is the point, and isolation is the thing it gives up

A container here is not a box you push things into. It mounts your real home directory, reaches your display and audio, sees your devices and can run commands back on the host, and an application installed inside it can be exported so it shows up in the host's normal menu. The result feels less like a container and more like having a second distribution's package manager available.

The documentation is unusually honest that this is a trade rather than a free win, stating that sandboxing is not an aim and that you should not expect the isolation a plain container or a Flatpak gives you. Take that literally. Anything you would hesitate to run as yourself belongs somewhere else, because this has your whole home directory.

## It is mid rewrite, and the version to run is the old one

The project is moving from its original shell implementation to a single Go binary. The Go line is still a release candidate, the shell line remains what the install script recommends for production, and both are frozen to bugfixes until the rewrite reaches parity, with no committed date for that.

None of this makes it a bad bet, since it ships in the default repositories of most major distributions and comes preinstalled on several immutable ones. It does mean you should install it from your distribution rather than from a script you found, and expect exported applications to need redoing when the new line lands.

## Reach for it when

- you run an immutable or atomic system and need somewhere mutable for ordinary packages
- your work laptop is locked down and you want an environment you control without asking for root
- you want a deliberately stable base with a bleeding edge toolchain on top of it

## Watch out for

- it is not a sandbox and does not try to be, so it is the wrong tool for anything you would not already run as yourself
- with docker as the backend the container runs as root, and root inside it can change things outside it
- turning on systemd inside a container switches off the host process integration that was the reason to use it
- the Go rewrite is still a release candidate while the shell line is what is recommended, and both are frozen to bugfixes
- Nvidia needs an explicit flag or a separately configured toolkit, and on macOS it is command line only

## Get started

Prefer your distribution's package, otherwise the recommended line:

```sh
curl -fsSL https://raw.githubusercontent.com/89luca89/distrobox/legacy/install | sh
```

---

aiarabicdev is a free directory of open source tools. No affiliate links, no sponsored placements.
New entries are announced at https://t.me/arabic_Intelligence
