DISTROBOX-ASSEMBLE(1) User Manual DISTROBOX-ASSEMBLE(1) (NAME) distrobox-assemble - (DESCRIPTION) distrobox-assemble . ./distrobox.ini --file . (SYNOPSIS) distrobox assemble --file: (URL) /ini --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 # You can add comments using this # [arch] # also inline comments are supported 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) : . . (Available options) : : 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) (mount) exported_apps string_list desktop (export) exported_bins string_list (export) exported_bins_path string (: $HOME/.local/bin) entry bool (: false) start_now bool (: false) init bool init (: 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 (network namespace) (unshare) (: false) unshare_process bool (pid namespace) (unshare) (: false) unshare_devsys bool /dev (unshare) (: false) unshare_all bool (unshare) (: false) include . (Recursive) . distrobox . . distrobox create create . (Advanced example) [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 example) [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; (Custom login shell example) [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 Distrobox Mar 2026 DISTROBOX-ASSEMBLE(1)