DISTROBOX-CREATE(1) User Manual DISTROBOX-CREATE(1) (NAME) distrobox-create - distrobox (DESCRIPTION) distrobox-create (image) . HOME USB (X11/Wayland) . (SYNOPSIS) distrobox create --image/-i: : ${container_image_default} --name/-n: distrobox : ${container_name_default} --hostname: (hostname) distrobox : .$(uname -n) --pull/-p: ( --yes) --yes/-Y: --root/-r: podman/docker/lilipod (root). root "sudo distrobox" (: 'sudo' root DBX_SUDO_PROGRAM 'distrobox_sudo_program' ) --clone/-c: distrobox distrobox . --home/-H: HOME . home . --volume: (volumes) --additional-flags/-a: --additional-packages/-ap: --init-hooks: --pre-init-hooks: --init/-I: init ( systemd) . ( --unshare-process). : https://github.com/89luca89/distrobox/blob/main/docs/useful_tips.md#using-init-system-inside-a-distrobox --nvidia: nVidia --platform: : linux/arm64 --unshare-devsys: sysfs --unshare-groups: --unshare-ipc: ipc --unshare-netns: (net) --unshare-process: --unshare-all: unshare --compatibility/-C: --help/-h: --no-entry: --dry-run/-d: --verbose/-v: --version/-V: --absolutely-disable-root-password-i-am-really-positively-sure: distrobox (rootful) . (COMPATIBILITY) : man distrobox man distrobox-compatibility : https://github.com/89luca89/distrobox/blob/main/docs/compatibility.md#containers-distros (EXAMPLES) distrobox alpine my-alpine-container distrobox create --image alpine my-alpine-container distrobox fedora-toolbox:35 distrobox create --image registry.fedoraproject.org/fedora-toolbox:35 --name fedora-toolbox-35 distrobox distrobox create --clone fedora-35 --name fedora-35-copy distrobox distrobox create --pull --image centos:stream9 --home ~/distrobox/centos9 distrobox create --image fedora:35 --name test --additional-flags "--env MY_VAR=value" (volumes) distrobox create --image fedora:35 --name test --volume /opt/my-dir:/usr/local/my-dir:rw --additional-flags "--pids-limit -1" distrobox create --image alpine:latest --name test2 --additional-packages "git tmux vim" init-hooks distrobox create --image alpine:latest --name test --init-hooks "touch /var/tmp/test1 && touch /var/tmp/test2" pre-init-hooks ( ) distrobox create -i docker.io/almalinux/8-init --init --name test --pre-init-hooks "dnf config-manager --enable powertools && dnf -y install epel-release" init Systemd ( LXC ): distrobox create -i ubuntu:latest --name test --additional-packages "systemd libpam-systemd pipewire-audio-client-libraries" --init init OpenRC ( LXC ): distrobox create -i alpine:latest --name test --additional-packages "openrc" --init NVidia distrobox create --image ubuntu:22.04 --name ubuntu-nvidia --nvidia IP : distrobox create --image ubuntu:latest --name test --unshare-netns $HOME ( /run/host) : distrobox create --name unshared-test --unshare-all init LXC : distrobox create --name unshared-init-test --unshare-all --init --image fedora:latest : DBX_CONTAINER_MANAGER="docker" DBX_NON_INTERACTIVE=1 DBX_CONTAINER_NAME=test-alpine DBX_CONTAINER_IMAGE=alpine distrobox-create (ENVIRONMENT) DBX_CONTAINER_ALWAYS_PULL DBX_CONTAINER_CUSTOM_HOME DBX_CONTAINER_HOME_PREFIX DBX_CONTAINER_IMAGE DBX_CONTAINER_MANAGER DBX_CONTAINER_NAME DBX_CONTAINER_HOSTNAME DBX_NON_INTERACTIVE DBX_SUDO_PROGRAM DBX_CONTAINER_HOME_PREFIX home . ~/dbx home ~/dbx/$container_name . (EXTRA) --additional-flags -a . : distrobox create -i docker.io/library/archlinux -n dev-arch podman container inspect dev-arch | jq '.[0].HostConfig.PidsLimit' 2048 distrobox rm -f dev-arch distrobox create -i docker.io/library/archlinux -n dev-arch --volume $CBL_TC:/tc --additional-flags "--pids-limit -1" podman container inspect dev-arch | jq '.[0].HostConfig,.PidsLimit' 0 --volume . docker podman : --volume SOURCE_PATH:DEST_PATH:MODE. distrobox create --image docker.io/library/archlinux --name dev-arch --volume /usr/share/:/var/test:ro ( additional-flags) : distrobox create --image fedora:35 --name test --additional-flags "--env MY_VAR=value" --init-hooks (init) . . distrobox create --image fedora:35 --name test --init-hooks "dnf groupinstall -y \"C Development Tools and Libraries\"" --init init . : distrobox create -i docker.io/almalinux/8-init --init --name test distrobox create -i docker.io/library/debian --additional-packages "systemd" --init --name test-debian systemd : ~$ distrobox enter test user@test:~$ sudo systemctl enable --now sshd user@test:~$ sudo systemctl status sshd sshd.service - OpenSSH server daemon Loaded: loaded (/usr/lib/systemd/system/sshd.service; enabled; vendor preset: enabled) Active: active (running) since Fri 2022-01-28 22:54:50 CET; 17s ago Docs: man:sshd(8) man:sshd_config(5) Main PID: 291 (sshd) --init . . /sbin/init (PID 1) . init : distrobox create -i alpine:latest --init --additional-packages "openrc" -n test distrobox create -i debian:stable --init --additional-packages "systemd libpam-systemd pipewire-audio-client-libraries" -n test distrobox create -i ubuntu:22.04 --init --additional-packages "systemd libpam-systemd pipewire-audio-client-libraries" -n test distrobox create -i archlinux:latest --init --additional-packages "systemd" -n test distrobox create -i registry.opensuse.org/opensuse/tumbleweed:latest --init --additional-packages "systemd" -n test distrobox create -i registry.fedoraproject.org/fedora:39 --init --additional-packages "systemd" -n test --init (VM) . init (user-session) . --home HOME . home dotfile . --root (root) . enter . sudo/su rootful ! --absolutely-disable-root-password-i-am-really-positively-sure . . 1.4.0 distrobox . NVidia (NVidia integration) NVidia --nvidia : distrobox create --nvidia --image ubuntu:latest --name ubuntu-nvidia glibc . : o Almalinux o Archlinux o Centos 7 o Clearlinux o Debian 10 o OpenSUSE Leap o OpenSUSE Tumbleweed o Rockylinux o Ubuntu 18.04 o Void Linux ( glibc) Distrobox Mar 2026 DISTROBOX-CREATE(1)