DISTROBOX-UPGRADE(1) User Manual DISTROBOX-UPGRADE(1) (NAME) distrobox-assemble - (DESCRIPTION) distrobox-assemble . ./distrobox.ini --file . (SYNOPSIS) distrobox assemble --file: (URL) /ini distrobox --name/-n: /ini --replace/-R: distrobox --dry-run/-d: --verbose/-v: --version/-V: (EXAMPLES) : [ubuntu] additional_packages="git vim tmux nodejs" image=ubuntu:latest init=false nvidia=false pull=true root=false replace=true start_now=false # # [arch] # additional_packages="git vim tmux nodejs" home=/tmp/home image=archlinux:latest init=false start_now=true init_hooks="touch /init-normal" nvidia=true pre_init_hooks="touch /pre-init" pull=true root=false replace=false volume="/tmp/test:/run/a /tmp/test:/run/b" (Create) : distrobox assemble create distrobox.ini . : distrobox assemble create --file /my/custom/path.ini (URL) : distrobox-assemble create --file https://raw.githubusercontent.com/89luca89/dotfiles/master/distrobox.ini (Replace) distrobox assemble replace=true . ubuntu distrobox assemble create arch . --replace : distrobox assemble create --replace [--file my/custom/path.ini] (Remove) : distrobox assemble rm ini: distrobox assemble rm --file my/custom/path.ini (Test) --dry-run distrobox . distrobox . (Clone) : . . : : o bool: true false o string: home="/home/luca-linux/dbox" o string_list: additional_packages="htop vim git". string_list : [ubuntu] image=ubuntu:latest additional_packages="git vim tmux nodejs" additional_packages="htop iftop iotop" additional_packages="zsh fish" ------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------ additional_flags string_list additional_packages string_list home string (home) hostname string (hostname) image string clone string Distrobox ( ). include string . init_hooks string_list pre_init_hooks string_list volume string_list (volume) exported_apps string_list desktopfile exported_bins string_list () exported_bins_path string (: $HOME/.local/bin) entry bool (: false) start_now bool (: false) init bool initful (: false) nvidia bool NVidia (: false) pull bool (pull) (: false) root bool (rootful) (: false) unshare_groups bool (unshare) (: false) unshare_ipc bool ipc (unshare) (: false) unshare_netns bool (unshare) (: false) unshare_process bool (pid) (unshare) (: false) unshare_devsys bool /dev (unshare) (: false) unshare_all bool (: false) .TE include . . distrobox . (shadow) . distrobox create create . [tumbleweed_distrobox] image=registry.opensuse.org/opensuse/distrobox pull=true additional_packages="acpi bash-completion findutils iproute iputils sensors inotify-tools unzip" additional_packages="net-tools nmap openssl procps psmisc rsync man tig tmux tree vim htop xclip yt-dlp" additional_packages="git git-credential-libsecret" additional_packages="patterns-devel-base-devel_basis" additional_packages="ShellCheck ansible-lint clang clang-tools codespell ctags desktop-file-utils gcc golang jq python3" additional_packages="python3-bashate python3-flake8 python3-mypy python3-pipx python3-pycodestyle python3-pyflakes python3-pylint python3-python-lsp-server python3-rstcheck python3-yapf python3-yamllint rustup shfmt" additional_packages="kubernetes-client helm" init_hooks=GOPATH="${HOME}/.local/share/system-go" GOBIN=/usr/local/bin go install github.com/golangci/golangci-lint/cmd/golangci-lint@latest; init_hooks=GOPATH="${HOME}/.local/share/system-go" GOBIN=/usr/local/bin go install github.com/onsi/ginkgo/v2/ginkgo@latest; init_hooks=GOPATH="${HOME}/.local/share/system-go" GOBIN=/usr/local/bin go install golang.org/x/tools/cmd/goimports@latest; init_hooks=GOPATH="${HOME}/.local/share/system-go" GOBIN=/usr/local/bin go install golang.org/x/tools/gopls@latest; init_hooks=GOPATH="${HOME}/.local/share/system-go" GOBIN=/usr/local/bin go install sigs.k8s.io/kind@latest; init_hooks=ln -sf /usr/bin/distrobox-host-exec /usr/local/bin/conmon; init_hooks=ln -sf /usr/bin/distrobox-host-exec /usr/local/bin/crun; init_hooks=ln -sf /usr/bin/distrobox-host-exec /usr/local/bin/docker; init_hooks=ln -sf /usr/bin/distrobox-host-exec /usr/local/bin/docker-compose; init_hooks=ln -sf /usr/bin/distrobox-host-exec /usr/local/bin/flatpak; init_hooks=ln -sf /usr/bin/distrobox-host-exec /usr/local/bin/podman; init_hooks=ln -sf /usr/bin/distrobox-host-exec /usr/local/bin/xdg-open; exported_apps="htop" exported_bins="/usr/bin/htop /usr/bin/git" exported_bins_path="~/.local/bin" (Clone) [ubuntu] additional_packages="git vim tmux" image=ubuntu:latest init=false nvidia=false pull=true root=false replace=true start_now=true [deno_ubuntu] clone=ubuntu init=false nvidia=false pull=true root=false replace=true start_now=true pre_init_hooks=curl -fsSL https://deno.land/install.sh | sh; [bun_ubuntu] clone=ubuntu init=false nvidia=false pull=true root=false replace=true start_now=true pre_init_hooks=curl -fsSL https://bun.sh/install | bash; [ubuntu] image=ubuntu:latest pre_init_hooks="export SHELL=/bin/bash;" ( distrobox ) [ubuntu] image=ubuntu:latest additional_packages="git vim tmux nodejs" additional_packages="htop iftop iotop" additional_packages="zsh fish" [ubuntu-nvidia] include=ubuntu nvidia=true ' . OCI docker-hub quay.io . which mount less vi . . . . (mount) (usermod, passwd) sudo . " (SUPPORTED CONTAINER MANAGERS)" distrobox podman docker https://github.com/89luca89/lilipod lilipod . podman rootless docker sudo ( https://docs.docker.com/engine/install/linux-postinstall ) o 2 podman: 2.1.0 o 2 docker: 19.03.15 o 2 lilipod: v0.0.1 : o 2 https://podman.io/getting-started/installation o 2 https://docs.docker.com/engine/install o 2 https://docs.docker.com/engine/install/linux-postinstall " (CONTAINERS DISTROS)" Distrobox : tab(@); lw(23.3n) lw(23.3n) lw(23.3n). T{ T} ------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------ AlmaLinux (Toolbox) 8 9 quay.io/toolbx-images/almalinux-toolbox:8 quay.io/toolbx-images/almalinux-toolbox:9 quay.io/toolbx-images/almalinux-toolbox:latest Alpine (Toolbox) 3.20 3.21 3.22 edge quay.io/toolbx-images/alpine-toolbox:3.20 quay.io/toolbx-images/alpine-toolbox:3.21 quay.io/toolbx-images/alpine-toolbox:3.22 quay.io/toolbx-images/alpine-toolbox:edge quay.io/toolbx-images/alpine-toolbox:latest AmazonLinux (Toolbox) 2 2022 quay.io/toolbx-images/amazonlinux-toolbox:2 quay.io/toolbx-images/amazonlinux-toolbox:2023 quay.io/toolbx-images/amazonlinux-toolbox:latest Archlinux (Toolbox) quay.io/toolbx/arch-toolbox:latest ALT Linux p10 p11 sisyphus docker.io/library/alt:p10 docker.io/library/alt:p11 docker.io/library/alt:sisyphus Bazzite Arch ghcr.io/ublue-os/bazzite-arch:latest ghcr.io/ublue-os/bazzite-arch-gnome:latest Centos (Toolbox) stream9 stream10 quay.io/toolbx-images/centos-toolbox:stream9 quay.io/toolbx-images/centos-toolbox:stream10 quay.io/toolbx-images/centos-toolbox:latest Debian (Toolbox) 11 12 13 testing quay.io/toolbx-images/debian-toolbox:11 unstable quay.io/toolbx-images/debian-toolbox:12 quay.io/toolbx-images/debian-toolbox:13 quay.io/toolbx-images/debian-toolbox:testing quay.io/toolbx-images/debian-toolbox:unstable quay.io/toolbx-images/debian-toolbox:latest Fedora (Toolbox) 38 39 40 41 42 43 registry.fedoraproject.org/fedora-toolbox:38 Rawhide registry.fedoraproject.org/fedora-toolbox:39 registry.fedoraproject.org/fedora-toolbox:40 quay.io/fedora/fedora-toolbox:41 quay.io/fedora/fedora-toolbox:42 quay.io/fedora/fedora-toolbox:43 quay.io/fedora/fedora-toolbox:rawhide openSUSE (Toolbox) registry.opensuse.org/opensuse/distrobox:latest RedHat (Toolbox) 8 9 registry.access.redhat.com/ubi8/toolbox registry.access.redhat.com/ubi9/toolbox Rocky Linux (Toolbox) 8 9 quay.io/toolbx-images/rockylinux-toolbox:8 quay.io/toolbx-images/rockylinux-toolbox:9 quay.io/toolbx-images/rockylinux-toolbox:latest Ubuntu (Toolbox) 16.04 18.04 20.04 quay.io/toolbx/ubuntu-toolbox:16.04 22.04 24.04 quay.io/toolbx/ubuntu-toolbox:18.04 quay.io/toolbx/ubuntu-toolbox:20.04 quay.io/toolbx/ubuntu-toolbox:22.04 quay.io/toolbx/ubuntu-toolbox:24.04 quay.io/toolbx/ubuntu-toolbox:latest Chainguard Wolfi (Toolbox) quay.io/toolbx-images/wolfi-toolbox:latest Ublue ubuntu-toolbox ghcr.io/ublue-os/ubuntu-toolbox fedora-toolbox ghcr.io/ublue-os/fedora-toolbox wolfi-toolbox ghcr.io/ublue-os/wolfi-toolbox archlinux-distrobox ghcr.io/ublue-os/arch-toolbox AlmaLinux 8 8-minimal 9 docker.io/library/almalinux:8 9-minimal docker.io/library/almalinux:9 Alpine Linux 3.20 3.21 3.22 edge docker.io/library/alpine:3.20 docker.io/library/alpine:3.21 docker.io/library/alpine:3.22 docker.io/library/alpine:edge docker.io/library/alpine:latest AmazonLinux 1 2 2023 public.ecr.aws/amazonlinux/amazonlinux:1 public.ecr.aws/amazonlinux/amazonlinux:2 public.ecr.aws/amazonlinux/amazonlinux:2023 Archlinux docker.io/library/archlinux:latest Blackarch docker.io/blackarchlinux/blackarch:latest CentOS Stream 8 9 10 quay.io/centos/centos:stream8 quay.io/centos/centos:stream9 quay.io/centos/centos:stream10 Chainguard Wolfi cgr.dev/chainguard/wolfi-base:latest Chimera Linux docker.io/chimeralinux/chimera:latest Crystal Linux registry.gitlab.com/crystal-linux/misc/docker:latest Debian 7 8 9 10 11 12 13 docker.io/debian/eol:wheezy docker.io/debian/eol:buster docker.io/debian/eol:bullseye docker.io/library/debian:bookworm-backports docker.io/library/debian:stable-backports Debian Testing docker.io/library/debian:testing docker.io/library/debian:testing-backports Debian Unstable docker.io/library/debian:unstable deepin 20 (apricot) 23 (beige) docker.io/linuxdeepin/apricot docker.io/linuxdeepin/deepin:beige Fedora 38 39 40 41 42 43 quay.io/fedora/fedora:38 quay.io/fedora/fedora:39 Rawhide quay.io/fedora/fedora:40 quay.io/fedora/fedora:41 quay.io/fedora/fedora:42 quay.io/fedora/fedora:43 quay.io/fedora/fedora:rawhide Gentoo Linux rolling docker.io/gentoo/stage3:latest KDE neon Latest invent-registry.kde.org/neon/docker-images/plasma:latest Kali Linux rolling docker.io/kalilinux/kali-rolling:latest Mint 22.3 docker.io/linuxmintd/mint22.3-amd64 Neurodebian nd120 docker.io/library/neurodebian:nd120 openSUSE Leap registry.opensuse.org/opensuse/leap:latest openSUSE Tumbleweed registry.opensuse.org/opensuse/distrobox:latest registry.opensuse.org/opensuse/tumbleweed:latest registry.opensuse.org/opensuse/toolbox:latest registry.opensuse.org/opensuse/distrobox-bpftrace:latest Oracle Linux 8 8-slim 9 9-slim 10 container-registry.oracle.com/os/oraclelinux:8 10-slim container-registry.oracle.com/os/oraclelinux:8-slim container-registry.oracle.com/os/oraclelinux:9 container-registry.oracle.com/os/oraclelinux:9-slim container-registry.oracle.com/os/oraclelinux:10 container-registry.oracle.com/os/oraclelinux:10-slim RedHat (UBI) 7 8 9 registry.access.redhat.com/ubi7/ubi registry.access.redhat.com/ubi8/ubi registry.access.redhat.com/ubi8/ubi-init registry.access.redhat.com/ubi8/ubi-minimal registry.access.redhat.com/ubi9/ubi registry.access.redhat.com/ubi9/ubi-init registry.access.redhat.com/ubi9/ubi-minimal Rocky Linux 8 8-minimal 9 quay.io/rockylinux/rockylinux:8 quay.io/rockylinux/rockylinux:8-minimal quay.io/rockylinux/rockylinux:9 quay.io/rockylinux/rockylinux:latest Slackware docker.io/vbatts/slackware:current SteamOS ghcr.io/linuxserver/steamos:latest Ubuntu 14.04 16.04 18.04 docker.io/library/ubuntu:14.04 20.04 22.04 24.04 docker.io/library/ubuntu:16.04 docker.io/library/ubuntu:18.04 docker.io/library/ubuntu:20.04 docker.io/library/ubuntu:22.04 docker.io/library/ubuntu:24.04 Vanilla OS VSO ghcr.io/vanilla-os/vso:main Void Linux glibc musl ghcr.io/void-linux/void-glibc-full:latest ghcr.io/void-linux/void-musl-full:latest Toolbox https://github.com/toolbx-images/images toolbx-images/images . toolbox distrobox-enter . . . NixOS . (unprivileged) NixOS https://nixos.org/manual/nix/unstable/command-ref/nix-shell.html nix-shell https://github.com/DavHau/nix-portable nix portable . (NEW DISTRO SUPPORT) issue . issue ! (OLDER DISTRIBUTIONS) CentOS 5 CentOS 6 Debian 6 Ubuntu 12.04 . libc >=4.11 . vsyscall=emulate . distrobox . (GPU ACCELERATION SUPPORT) Intel AMD mesa/dri . NVidia --nvidia distrobox-create . nvidia-container-toolkit distrobox . " (NAME)" distrobox create distrobox-create " (DESCRIPTION)" distrobox-create . HOME usb (X11/Wayland) . " (SYNOPSIS)" distrobox create --image/-i: : ${container_image_default} --name/-n: distrobox : ${container_name_default} --hostname: distrobox : .$(uname -n) --pull/-p: ( --yes) --yes/-Y: --root/-r: podman/docker/lilipod . "sudo distrobox" (: 'sudo' DBX_SUDO_PROGRAM 'distrobox_sudo_program' ) --clone/-c: distrobox distrobox . --home/-H: HOME . . --volume: --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: 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 . " (COMPATIBILITY)" : man distrobox man distrobox-compatibility : https://github.com/89luca89/distrobox/blob/main/docs/compatibility.md#containers-distros " (EXAMPLES)" distrobox alpine my-alpine 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 (pull) distrobox distrobox create --pull --image centos:stream9 --home ~/distrobox/centos9 distrobox create --image fedora:35 --name test --additional-flags "--env MY_VAR=value" volume 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 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 . ~/dbx ~/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 (volumes) --volume . (mount point) 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 . : 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) . (mount) dotfile . --root (root) . enter . (rootful) sudo/su ! --absolutely-disable-root-password-i-am-really-positively-sure . . 1.4.0 distrobox ..SS NVidia NVidia --nvidia : distrobox create --nvidia --image ubuntu:latest --name ubuntu-nvidia glibc . : o 2 Almalinux o 2 Archlinux o 2 Centos 7 o 2 Clearlinux o 2 Debian 10 o 2 OpenSUSE Leap o 2 OpenSUSE Tumbleweed o 2 Rockylinux o 2 Ubuntu 18.04 o 2 Void Linux (glibc) " (NAME)" distrobox-enter - distrobox " (DESCRIPTION)" distrobox-enter . SHELL . -headless tty . " (SYNOPSIS)" distrobox enter --name/-n: distrobox : my-distrobox --/-e: : ${USER} --no-tty/-T: tty --no-workdir/-nw: --additional-flags/-a: --help/-h: --root/-r: podman/docker/lilipod root. root "sudo distrobox" (: 'sudo' root DBX_SUDO_PROGRAM 'distrobox_sudo_program' ) --dry-run/-d: --verbose/-v: --version/-V: " (EXAMPLES)" distrobox "example" distrobox-enter example distrobox distrobox-enter --name fedora-toolbox-35 -- bash -l distrobox-enter my-alpine-container -- sh -l podman/docker/lilipod distrobox distrobox-enter --additional-flags "--preserve-fds" --name test -- bash -l distrobox distrobox-enter --additional-flags "--env MY_VAR=value" --name test -- bash -l MY_VAR=value distrobox-enter --additional-flags "--preserve-fds" --name test -- bash -l : DBX_CONTAINER_MANAGER="docker" DBX_CONTAINER_NAME=test-alpine distrobox-enter DBX_CONTAINER_NAME DBX_CONTAINER_MANAGER DBX_SKIP_WORKDIR DBX_SUDO_PROGRAM " (EXTRA)" distrobox . (profile) gnome-terminal . --additional-flags -a . : distrobox enter -n dev-arch --additional-flags "--env my_var=test" -- printenv &| grep my_var my_var=test : my_var=test distrobox enter -n dev-arch --additional-flags -- printenv &| grep my_var my_var=test (rootful) distrobox "sudo" podman/docker/lilipod "pkexec" "doas" DBX_SUDO_PROGRAM . "doas" : DBX_SUDO_PROGRAM="doas" distrobox enter -n container --root distrobox ~/.distroboxrc distrobox_sudo_program="doas" ( ) distrobox "doas" . " (NAME)" distrobox-ephemeral - distrobox distrobox ephemeral distrobox-ephemeral " (DESCRIPTION)" distrobox-ephemeral distrobox . " (SYNOPSIS)" distrobox ephemeral --root/-r: podman/docker/lilipod . "sudo distrobox" (: 'sudo' DBX_SUDO_PROGRAM 'distrobox_sudo_program' ) --verbose/-v: --help/-h: --/-e: : ${USER} --version/-V: " (EXAMPLES)" distrobox-ephemeral --image alpine:latest -- cat /etc/os-release distrobox-ephemeral --root --verbose --image alpine:latest --volume /opt:/opt distrobox-create . " (SEE ALSO)" distrobox-create --help man distrobox-create distrobox-ephemeral distrobox-create << >> distrobox-create(1) . " (NAME)" distrobox-export - " (DESCRIPTION)" distrobox-export . . " (SYNOPSIS)" distrobox-export --app/-a: desktopfile --bin/-b: --list-apps: --list-binaries -ep --delete/-d: --export-label/-el: . "none" . : (on \$container_name) --export-path/-ep: --extra-flags/-ef: --enter-flags/-nf: distrobox-enter --sudo/-S: sudo --help/-h: --verbose/-v: --version/-V: (CLI) distrobox . distrobox-export . " (EXAMPLES)" distrobox-export --app mpv [--extra-flags "flags"] [--delete] [--sudo] distrobox-export --bin /path/to/bin [--export-path ~/.local/bin] [--extra-flags "flags"] [--delete] [--sudo] distrobox-export --app abiword .desktop /usr/local/bin/distrobox-enter -n distrobox_name -e ... (home) . distrobox-export --app /opt/application/my-app.desktop desktopfile . distrobox-export --bin /usr/bin/code --extra-flags "--foreground" --export-path $HOME/.local/bin (--export-path) (wrapper script) distrobox-enter -e . direnv env . "-export-path" . electron "-foreground" : distrobox-export --app atom --extra-flags "--foreground" distrobox-export --bin /usr/bin/vim --export-path ~/.local/bin --extra-flags "-p" . . "-delete" (un-export) : distrobox-export --app atom --delete distrobox-export --bin /usr/bin/vim --export-path ~/.local/bin --delete "-sudo" (root) distrobox . -app -bin . [: https://user-images.githubusercontent.com/598882/144294795-c7785620-bf68-4d1b-b251-1e1f0a32a08d.png app-export ] app-export : electron vscode atom --extra-flags : distrobox-export --app atom --extra-flags "--foreground" distrobox generate-entry - distrobox " (DESCRIPTION)" distrobox-generate-entry distrobox . distrobox . " (SYNOPSIS)" distrobox generate-entry --help/-h: --all/-a: distrobox --delete/-d: --icon/-i: [/path/to/icon] ( auto) --root/-r: distrobox (rootful) --verbose/-v: --version/-V: " (EXAMPLES)" distrobox generate-entry my-container-name distrobox generate-entry my-container-name --icon /path/to/icon.png distrobox distrobox generate-entry --all distrobox generate-entry container-name --delete " (NAME)" distrobox-host-exec - " (DESCRIPTION)" distrobox-host-exec . distrobox-host-exec host-spawn . . " (SYNOPSIS)" ( ) "distrobox-host-exec" . --help/-h: --verbose/-v: --version/-V: --yes/-Y: : host-spawn . . "$SHELL" . distrobox-host-exec (symlink) . " (EXAMPLES)".SS distrobox-host-exec ls distrobox-host-exec bash -l distrobox-host-exec flatpak run org.mozilla.firefox distrobox-host-exec podman ps -a ~$: distrobox-host-exec # "$SHELL" ~$: distrobox-host-exec # You must run distrobox-host-exec inside a container! (symlink) distrobox-host-exec . . ~$: git # git bash: git: command not found ~$: sudo ln -s /usr/bin/distrobox-host-exec /usr/local/bin/git ~$: git version git version 2.51.1 podman : ~$: ln -s /usr/bin/distrobox-host-exec /usr/local/bin/podman ~$: ls -l /usr/local/bin/podman lrwxrwxrwx. 1 root root 51 Jul 11 19:26 /usr/local/bin/podman -> /usr/bin/distrobox-host-exec ~$: podman version ... ... " (NAME)" distrobox-init - distrobox ( ) " (DESCRIPTION)" distrobox ( ) distrobox-init (entrypoint) distrobox . distrobox . distrobox-create . distrobox-init ( sudo) (mount) . " (SYNOPSIS)" distrobox-init --name/-n: --user/-u: (UID) --group/-g: (GID) --home/-d: --help/-h: --additional-packages: --init/-I: init --pre-init-hooks: init --nvidia: nVidia --upgrade/-U: init --verbose/-v: --version/-V: --: init " (EXAMPLES)" distrobox-init --name test-user --user 1000 --group 1000 --home /home/test-user distrobox-init --upgrade distrobox list distrobox-list " (DESCRIPTION)" distrobox-list distrobox . . " (SYNOPSIS)" distrobox list --help/-h: --no-color: --root/-r: podman/docker/lilipod . "sudo distrobox" (: 'sudo' DBX_SUDO_PROGRAM 'distrobox_sudo_program' ) --verbose/-v: --version/-V: " (EXAMPLES)" distrobox-list : DBX_CONTAINER_MANAGER="docker" distrobox-list " (ENVIRONMENT)" DBX_CONTAINER_MANAGER DBX_SUDO_PROGRAM [IMAGE: https://user-images.githubusercontent.com/598882/147831082-24b5bc2e-b47e-49ac-9b1a-a209478c9705.png image ] image " (NAME)" distrobox rm distrobox-rm " (DESCRIPTION)" distrobox-rm distrobox . " (SYNOPSIS)" distrobox rm --all/-a: distrobox --force/-f: --rm-home: --root/-r: podman/docker/lilipod . "sudo distrobox" (: 'sudo' DBX_SUDO_PROGRAM 'distrobox_sudo_program' ) --help/-h: --verbose/-v: --version/-V: " (EXAMPLES)" distrobox-rm container-name [--force] [--all] : DBX_CONTAINER_MANAGER="docker" DBX_CONTAINER_NAME=test-alpine distrobox-rm DBX_CONTAINER_MANAGER DBX_CONTAINER_NAME DBX_NON_INTERACTIVE DBX_SUDO_PROGRAM " (NAME)" distrobox stop distrobox-stop " (DESCRIPTION)" distrobox-stop distrobox . distrobox . . " (SYNOPSIS)" distrobox stop --all/-a: distrobox --yes/-Y: --help/-h: --root/-r: podman/docker/lilipod root. root "sudo distrobox" (: 'sudo' root DBX_SUDO_PROGRAM 'distrobox_sudo_program' ) --verbose/-v: --version/-V: " (EXAMPLES)" distrobox-stop container-name1 container-name2 distrobox-stop container-name distrobox-stop --all : DBX_CONTAINER_MANAGER="docker" DBX_CONTAINER_NAME=test-alpine distrobox-stop " (ENVIRONMENT VARIABLES)" DBX_CONTAINER_MANAGER DBX_CONTAINER_NAME DBX_NON_INTERACTIVE DBX_SUDO_PROGRAM " (NAME)" distrobox-upgrade " (DESCRIPTION)" distrobox-upgrade . " (SYNOPSIS)" distrobox upgrade --help/-h: --all/-a: distrobox --running: distrobox --root/-r: podman/docker/lilipod root. root "sudo distrobox" (: 'sudo' root DBX_SUDO_PROGRAM 'distrobox_sudo_program' ) --verbose/-v: --version/-V: distrobox distrobox-upgrade --all distrobox distrobox-upgrade --all --running distrobox distrobox-upgrade alpine-linux distrobox distrobox-upgrade alpine-linux ubuntu22 my-distrobox123 distro systemd distrobox-upgrade : ~/.config/systemd/user/distrobox-upgrade.service [Unit] Description=distrobox-upgrade Automatic Update [Service] Type=simple ExecStart=distrobox-upgrade --all StandardOutput=null ~/.config/systemd/user/distrobox-upgrade.timer [Unit] Description=distrobox-upgrade Automatic Update Trigger [Timer] OnBootSec=1h OnUnitInactiveSec=1d [Install] WantedBy=timers.target : systemctl --user daemon-reload && systemctl --user enable --now distrobox-upgrade.timer Distrobox Mar 2026 DISTROBOX-UPGRADE(1)