[{"data":1,"prerenderedAt":-1},["ShallowReactive",2],{"project-9978":3},{"id":4,"name":5,"fullName":6,"owner":7,"repo":5,"description":8,"homepage":9,"htmlUrl":10,"language":11,"languages":10,"totalLinesOfCode":10,"stars":12,"forks":13,"watchers":14,"openIssues":15,"contributorsCount":16,"subscribersCount":16,"size":16,"stars1d":17,"stars7d":18,"stars30d":19,"stars90d":16,"forks30d":16,"starsTrendScore":20,"compositeScore":21,"rankGlobal":10,"rankLanguage":10,"license":22,"archived":23,"fork":23,"defaultBranch":24,"hasWiki":25,"hasPages":25,"topics":26,"createdAt":10,"pushedAt":10,"updatedAt":47,"readmeContent":48,"aiSummary":49,"trendingCount":16,"starSnapshotCount":16,"syncStatus":50,"lastSyncTime":51,"discoverSource":52},9978,"distrobox","89luca89\u002Fdistrobox","89luca89","Use any linux distribution inside your terminal. Enable both backward and forward compatibility with software and freedom to use whatever distribution you’re more comfortable with. Mirror available at: https:\u002F\u002Fgitlab.com\u002F89luca89\u002Fdistrobox","https:\u002F\u002Fdistrobox.it\u002F",null,"Shell",12583,525,58,115,0,4,34,184,26,103.16,"GNU General Public License v3.0",false,"main",true,[27,28,29,30,31,32,33,34,35,36,37,38,39,40,41,42,43,44,45,46],"almalinux","alpine","archlinux","bash","centos","command-line","containers","debian","development","docker","fedora","linux","opensuse","podman","posix","posix-sh","rockylinux","suse","tools","ubuntu","2026-06-12 04:00:47","\u003Cimg src=\"assets\u002Fsplash.svg\" style=\"border-radius:12px\">\n\n# Distrobox\n\n\u003Csub>previous logo credits [j4ckr3d](https:\u002F\u002Fgithub.com\u002Fj4ckr3d)  \ncurrent logo credits [David Lapshin](https:\u002F\u002Fgithub.com\u002Fdaudix)\u003Csub>\n\n[![Lint](https:\u002F\u002Fgithub.com\u002F89luca89\u002Fdistrobox\u002Factions\u002Fworkflows\u002Fmain.yml\u002Fbadge.svg)](https:\u002F\u002Fgithub.com\u002F89luca89\u002Fdistrobox\u002Factions\u002Fworkflows\u002Fmain.yml)\n[![CI](https:\u002F\u002Fgithub.com\u002F89luca89\u002Fdistrobox\u002Factions\u002Fworkflows\u002Fcompatibility.yml\u002Fbadge.svg)](https:\u002F\u002Fgithub.com\u002F89luca89\u002Fdistrobox\u002Factions\u002Fworkflows\u002Fcompatibility.yml)\n[![GitHub](https:\u002F\u002Fimg.shields.io\u002Fgithub\u002Flicense\u002F89luca89\u002Fdistrobox?color=blue)](..\u002FCOPYING.md)\n[![GitHub release (latest by date)](https:\u002F\u002Fimg.shields.io\u002Fgithub\u002Fv\u002Frelease\u002F89luca89\u002Fdistrobox)](https:\u002F\u002Fgithub.com\u002F89luca89\u002Fdistrobox\u002Freleases\u002Flatest)\n[![Packaging status](https:\u002F\u002Frepology.org\u002Fbadge\u002Ftiny-repos\u002Fdistrobox.svg)](https:\u002F\u002Frepology.org\u002Fproject\u002Fdistrobox\u002Fversions)\n[![GitHub issues by-label](https:\u002F\u002Fimg.shields.io\u002Fgithub\u002Fissues-search\u002F89luca89\u002Fdistrobox?query=is%3Aissue%20is%3Aopen%20label%3Abug%20-label%3Await-on-user%20&label=Open%20Bug%20Reports&color=red)](https:\u002F\u002Fgithub.com\u002F89luca89\u002Fdistrobox\u002Fissues?q=is%3Aissue+is%3Aopen+label%3Abug+-label%3Await-on-user)\n\nUse any Linux distribution inside your terminal. Enable both backward and forward\ncompatibility with software and freedom to use whatever distribution you’re more\ncomfortable with.\nDistrobox uses `podman`, `docker` or\n[`lilipod`](https:\u002F\u002Fgithub.com\u002F89luca89\u002Flilipod) to create containers using the Linux distribution\nof your choice.\nThe created container will be tightly integrated with the host, allowing sharing\nof the HOME directory of the user, external storage, external USB devices and\ngraphical apps (X11\u002FWayland), and audio.\n\n---\n\n[Documentation](https:\u002F\u002Fdistrobox.it\u002F#distrobox) -\n[Matrix Room](https:\u002F\u002Fmatrix.to\u002F#\u002F%23distrobox:matrix.org) -\n[Telegram Group](https:\u002F\u002Ft.me\u002Fdistrobox_chat_new)\n\n---\n\n![overview](https:\u002F\u002Fuser-images.githubusercontent.com\u002F598882\u002F144294862-f6684334-ccf4-4e5e-85f8-1d66210a0fff.png)\n\n---\n\n> [!WARNING]  \n> Documentation on GitHub strictly refers to the code in the main branch. For the official documentation\n> Head over [https:\u002F\u002Fdistrobox.it](https:\u002F\u002Fdistrobox.it)\n\n- [Distrobox](#distrobox)\n  - [What it does](#what-it-does)\n    - [See it in action](#see-it-in-action)\n  - [Why?](#why)\n    - [Aims](#aims)\n      - [Security implications](#security-implications)\n- [Quick Start](#quick-start)\n- [Assemble Distrobox](#assemble-distrobox)\n- [Configure Distrobox](#configure-distrobox)\n- [Installation](#installation)\n  - [Alternative methods](#alternative-methods)\n    - [Curl or Wget](#curl-or-wget)\n    - [Git](#git)\n  - [Dependencies](#dependencies)\n    - [Install Podman without root](compatibility.md#install-podman-in-a-static-manner)\n  - [Uninstallation](#uninstallation)\n- [Compatibility](compatibility.md)\n  - [Supported container managers](compatibility.md#supported-container-managers)\n  - [Host Distros](compatibility.md#host-distros)\n    - [Install on the Steamdeck](posts\u002Fsteamdeck_guide.md)\n  - [Containers Distros](compatibility.md#containers-distros)\n- [Usage](usage\u002Fusage.md)\n  - [Outside the distrobox](usage\u002Fusage.md#outside-the-distrobox)\n    - [distrobox-assemble](usage\u002Fdistrobox-assemble.md)\n    - [distrobox-create](usage\u002Fdistrobox-create.md)\n    - [distrobox-enter](usage\u002Fdistrobox-enter.md)\n    - [distrobox-ephemeral](usage\u002Fdistrobox-ephemeral.md)\n    - [distrobox-generate-entry](usage\u002Fdistrobox-generate-entry.md)\n    - [distrobox-list](usage\u002Fdistrobox-list.md)\n    - [distrobox-rm](usage\u002Fdistrobox-rm.md)\n    - [distrobox-stop](usage\u002Fdistrobox-stop.md)\n    - [distrobox-upgrade](usage\u002Fdistrobox-upgrade.md)\n  - [Inside the distrobox](usage\u002Fusage.md#inside-the-distrobox)\n    - [distrobox-export](usage\u002Fdistrobox-export.md)\n    - [distrobox-host-exec](usage\u002Fdistrobox-host-exec.md)\n    - [distrobox-init](usage\u002Fdistrobox-init.md)\n  - [Configure distrobox](#configure-distrobox)\n- [Useful tips](useful_tips.md)\n  - [Launch a distrobox from your applications list](useful_tips.md#launch-a-distrobox-from-your-applications-list)\n  - [Create a distrobox with a custom HOME directory](useful_tips.md#create-a-distrobox-with-a-custom-home-directory)\n  - [Mount additional volumes in a distrobox](useful_tips.md#mount-additional-volumes-in-a-distrobox)\n  - [Use a different shell than the host](useful_tips.md#use-a-different-shell-than-the-host)\n  - [Run the container with real root](useful_tips.md#run-the-container-with-real-root)\n  - [Run Debian\u002FUbuntu container behind proxy](useful_tips.md#run-debianubuntu-container-behind-proxy)\n  - [Using a command other than sudo to run a rootful container](useful_tips.md#using-a-command-other-than-sudo-to-run-a-rootful-container)\n  - [Duplicate an existing distrobox](useful_tips.md#duplicate-an-existing-distrobox)\n  - [Export to the host](useful_tips.md#export-to-the-host)\n  - [Execute commands on the host](useful_tips.md#execute-commands-on-the-host)\n  - [Resolve \"Error cannot open display: :0\"](useful_tips.md#resolve-error-cannot-open-display-0)\n  - [Enable SSH X-Forwarding when SSH-ing in a distrobox](useful_tips.md#enable-ssh-x-forwarding-when-ssh-ing-in-a-distrobox)\n  - [Using init system inside a distrobox](useful_tips.md#using-init-system-inside-a-distrobox)\n  - [Using Docker inside a Distrobox](useful_tips.md#using-docker-inside-a-distrobox)\n  - [Using Podman inside a Distrobox](useful_tips.md#using-podman-inside-a-distrobox)\n  - [Using LXC inside a Distrobox](useful_tips.md#using-lxc-inside-a-distrobox)\n  - [Using Waydroid inside a Distrobox](useful_tips.md#using-waydroid-inside-a-distrobox)\n    - [Manual Installation](useful_tips.md#manual-installation)\n    - [Automated Installation](useful_tips.md#automated-installation)\n  - [Using host's Podman or Docker inside a Distrobox](useful_tips.md#using-hosts-podman-or-docker-inside-a-distrobox)\n  - [Using distrobox as main cli](useful_tips.md#using-distrobox-as-main-cli)\n  - [Using a different architecture](useful_tips.md#using-a-different-architecture)\n  - [Using the GPU inside the container](useful_tips.md#using-the-gpu-inside-the-container)\n    - [Using nvidia-container-toolkit](useful_tips.md#using-nvidia-container-toolkit)\n  - [Slow creation on podman and image size getting bigger with distrobox create](useful_tips.md#slow-creation-on-podman-and-image-size-getting-bigger-with-distrobox-create)\n  - [Container save and restore](useful_tips.md#container-save-and-restore)\n  - [Check used resources](useful_tips.md#check-used-resources)\n  - [Pre-installing additional package repositories](useful_tips.md#pre-installing-additional-package-repositories)\n  - [Apply resource limitation on the fly](useful_tips.md#apply-resource-limitation-on-the-fly)\n- [Posts](posts\u002Fposts.md)\n  - [Announcing the next generation of Distrobox](posts\u002Fannouncing_distrobox_next.md)\n  - [Distrobox Next architecture](posts\u002Fdistrobox_next_architecture.md)\n  - [Create a dedicated distrobox container](posts\u002Fdistrobox_custom.md)\n  - [Execute a command on the Host](posts\u002Fexecute_commands_on_host.md)\n  - [Install Podman in HOME](posts\u002Finstall_podman_static.md)\n  - [Install Lilipod in HOME](posts\u002Finstall_lilipod_static.md)\n  - [Install on Steamdeck](posts\u002Fsteamdeck_guide.md)\n  - [Integrate VSCode and Distrobox](posts\u002Fintegrate_vscode_distrobox.md)\n  - [Run Libvirt using distrobox](posts\u002Frun_libvirt_in_distrobox.md)\n  - [Run latest GNOME and KDE Plasma using distrobox](posts\u002Frun_latest_gnome_kde_hyprland_on_distrobox.md)\n- [Featured Articles](featured_articles.md)\n  - [Articles](featured_articles.md#articles)\n    - [Run Distrobox on Fedora Linux - Fedora Magazine](https:\u002F\u002Ffedoramagazine.org\u002Frun-distrobox-on-fedora-linux\u002F)\n    - [DistroBox – Run Any Linux Distribution Inside Linux Terminal - TecMint](https:\u002F\u002Fwww.tecmint.com\u002Fdistrobox-run-any-linux-distribution\u002F)\n    - [Distrobox: Try Multiple Linux Distributions via the Terminal - It's FOSS](https:\u002F\u002Fitsfoss.com\u002Fdistrobox\u002F)\n    - [Distrobox - How to quickly deploy a Linux distribution with GUI applications via a container](https:\u002F\u002Fwww.techrepublic.com\u002Farticle\u002Fhow-to-quickly-deploy-a-linux-distribution-with-gui-applications-via-a-container\u002F)\n    - [Using Distrobox To Augment The Package Selection On Clear Linux - Phoronix](https:\u002F\u002Fwww.phoronix.com\u002Fscan.php?page=news_item&px=Distrobox-Clear-Linux)\n    - [Benchmark: benefits of Clear Linux containers (distrobox) - Phoronix](https:\u002F\u002Fwww.phoronix.com\u002Fforums\u002Fforum\u002Fphoronix\u002Flatest-phoronix-articles\u002F1305326-clear-linux-container-performance-continues-showing-sizable-gains)\n    - [Distrobox - A great item in the Linux toolbelt - phmurphy's blog](https:\u002F\u002Fphmurphy.com\u002Fposts\u002Fdistrobox-toolbelt\u002F)\n    - [Distrobox: Run (pretty much) any Linux distro under almost any other - TheRegister](https:\u002F\u002Fwww.theregister.com\u002F2022\u002F05\u002F31\u002Fdistrobox_130_released\u002F)\n    - [Day-to-day differences between Fedora Silverblue and Ubuntu - castrojo's blog](https:\u002F\u002Fwww.ypsidanger.com\u002Fday-to-day-advantages-of-fedora-silverblue\u002F)\n    - [Distrobox is Awesome - Running Window Manager and Desktop environments using Distrobox](https:\u002F\u002Fcloudyday.tech.blog\u002F2022\u002F05\u002F14\u002Fdistrobox-is-awesome\u002F)\n    - [Japanese input on Clear Linux with Mozc via Ubuntu container with Distrobox](https:\u002F\u002Fimpsbl.hatenablog.jp\u002Fentry\u002FJapaneseInputOnClearLinuxWithMozc_en)\n    - [MID (MaXX Interactive Desktop) on Clear Linux via Ubuntu container with Distrobox](https:\u002F\u002Fimpsbl.hatenablog.jp\u002Fentry\u002FMIDonClearLinuxWithDistrobox_en)\n    - [Running Other Linux Distros with Distrobox on Fedora Linux - bandithijo's blog](featured_articles.md)\n  - [Talks and Videos](featured_articles.md#talks)\n    - [Linux App Summit 2022 - Distrobox: Run Any App On Any Distro - BoF](https:\u002F\u002Fgithub.com\u002F89luca89\u002Fdistrobox\u002Ffiles\u002F8598433\u002Fdistrobox-las-talk.pdf)\n    - [Opensource Summit 2022 - Distrobox: Run Any App On Any Distro](https:\u002F\u002Fwww.youtube.com\u002Fwatch?v=eM1p47tow4o)\n    - [A \"Box\" Full of Tools and Distros - Dario Faggioli @ OpenSUSE Conference 2022](https:\u002F\u002Fwww.youtube.com\u002Fwatch?v=_RzARte80SQ)\n    - [Podman Community Meeting October 4, 2022](https:\u002F\u002Fwww.youtube.com\u002Fwatch?v=JNijOHL4_Ko)\n    - [Distrobox opens the Steam Deck to a whole new world (GUIDE) - GamingOnLinux](https:\u002F\u002Fwww.youtube.com\u002Fwatch?v=kkkyNA31KOA)\n    - [CERN - Containerization as a means of extending the lifetime of HDL development tools](https:\u002F\u002Fcdsweb.cern.ch\u002Frecord\u002F2859962?ln=ja)\n    - [How to Code with Distrobox on the Steam Deck](https:\u002F\u002Fwww.youtube.com\u002Fwatch?v=qic7lmACqPo)\n    - [Why you should be running the MicroOS Desktop](https:\u002F\u002Fwww.youtube.com\u002Fwatch?v=lKYLF1tA4Ik)\n  - [Podcasts](featured_articles.md#podcasts)\n\n---\n\n## What it does\n\nSimply put it's a fancy wrapper around `podman`, `docker`, or `lilipod` to create and start\ncontainers which are highly integrated with the hosts.\n\nThe distrobox environment is based on an [OCI image](https:\u002F\u002Fgithub.com\u002Fopencontainers\u002Fimage-spec).\nThis image is used to create a container that seamlessly integrates with the\nrest of the operating system by providing access to the user's home directory,\nthe Wayland and X11 sockets, networking, removable devices (like USB sticks),\nsystemd journal, SSH agent, D-Bus,\nulimits, \u002Fdev and the udev database, etc...\n\nIt implements the same concepts introduced by \u003Chttps:\u002F\u002Fgithub.com\u002Fcontainers\u002Ftoolbox>\nbut in a simplified way, using POSIX sh and aiming at broader compatibility.\n\nAll the props go to them as they had the great idea to implement this stuff.\n\nIt is divided into 12 commands:\n\n- `distrobox-assemble` – create and destroy containers based on a config file\n- `distrobox-create` – create a container\n- `distrobox-enter`  – enter a container\n- `distrobox-ephemeral`  – create a temporal container, destroy it when exiting the shell\n- `distrobox-list` – list containers created with distrobox\n- `distrobox-rm` – delete a container created with distrobox\n- `distrobox-stop` – stop a running container created with distrobox\n- `distrobox-upgrade` – upgrade one or more running containers created with distrobox at once\n- `distrobox-generate-entry` – create an entry of a created container in the applications list\n- `distrobox-init`   – entry point of the container (not meant to be used manually)\n- `distrobox-export` – use inside the container,\n  export apps and services from the container to the host\n- `distrobox-host-exec` – run commands\u002Fprograms from the host, while inside\n of the container\n\nIt also includes a little wrapper to launch commands with `distrobox COMMAND`\ninstead of calling the single files.\n\nPlease check [the usage docs](usage\u002Fusage.md) and [see some handy tips on how to use it](useful_tips.md).\n\n### See it in action\n\nThanks to [castrojo](https:\u002F\u002Fgithub.com\u002Fcastrojo), you can see Distrobox in\naction in this explanatory video on his setup with Distrobox, Toolbx,\nFedora Silverblue for the [uBlue](https:\u002F\u002Fgithub.com\u002Fublue-os) project\n(check it out!)\n\n[![Video](https:\u002F\u002Fuser-images.githubusercontent.com\u002F598882\u002F153680522-f5903607-2854-4cfb-a186-cba7403745bd.png)](https:\u002F\u002Fwww.youtube.com\u002Fwatch?v=Q2PrISAOtbY)\n\n## Why\n\n- Provide a mutable environment on an immutable OS, like [ChromeOS, Endless OS,\n  Fedora Atomic Desktops (e.g. Silverblue), OpenSUSE Aeon\u002FKalpa, Vanilla OS](compatibility.md#host-distros), or [SteamOS3](posts\u002Fsteamdeck_guide.md)\n- Provide a locally privileged environment for sudoless setups\n  (e.g. company-provided laptops, security reasons, etc...)\n- To mix and match a stable base system (e.g. Debian Stable, Ubuntu LTS, Red Hat)\n  with a bleeding-edge environment for development or gaming\n  (e.g. Arch, OpenSUSE Tumbleweed, or Fedora with the latest Mesa)\n- Leverage a high abundance of curated distro images for `docker`\u002F`podman` to\n  manage multiple environments.\n\nRefer to the compatibility list for an overview of the supported host distros\n[HERE](compatibility.md#host-distros) and container's distro [HERE](compatibility.md#containers-distros).\n\n### Aims\n\nThis project aims to bring **any distro userland to any other distro**\nsupporting `podman`, `docker`, or `lilipod`.\nIt has been written in POSIX shell to be as portable as possible and it does not have\nproblems with dependencies and `glibc` version's compatibility.\n\nRefer [HERE](compatibility.md#supported-container-managers) for a list of\nsupported container managers and minimum supported versions.\n\nIt also aims to enter the container **as fast as possible**, every millisecond\nadds up if you use the container as your default environment for your terminal:\n\nThese are some sample results of `distrobox-enter` on the same container on my\nweak laptop:\n\n```console\n~$ hyperfine --warmup 3 --runs 100 \"distrobox enter bench -- whoami\"\nBenchmark 1: distrobox enter bench -- whoami\n  Time (mean ± σ):     395.6 ms ±  10.5 ms    [User: 167.4 ms, System: 62.4 ms]\n  Range (min … max):   297.3 ms … 408.9 ms    100 runs\n```\n\n#### Security implications\n\nIsolation and sandboxing are **not** the main aims of the project, on the contrary\nit aims to tightly integrate the container with the host.\nThe container will have complete access to your home, pen drive, and so on,\nso do not expect it to be highly sandboxed like a plain\n`docker`\u002F`podman` container or a Flatpak.\n\n⚠️ **BE CAREFUL**:⚠️  if you use `docker`, or you use `podman`\u002F`lilipod` with the `--root\u002F-r` flag,\nthe containers will run as root, so **root inside the rootful container can modify\nsystem stuff outside the container**,\nBe also aware that **In rootful mode, you'll be asked to set up the user's password**, this will\nensure at least that the container is not a passwordless gate to root,\nbut if you have security concerns for this, **use `podman` or `lilipod` that runs in rootless mode**.\nRootless `docker` is still not working as intended and will be included in the future\nwhen it will be complete.\n\nThat said, it is useful to read the discussion about decoupling with the host,\navailable here: [#28 Sandboxed mode](https:\u002F\u002Fgithub.com\u002F89luca89\u002Fdistrobox\u002Fissues\u002F28).\n\nIf you are looking for something similar to Distrobox but with sandboxing capabilities,\nthere are other options to consider which do prioritise isolation such as [Litterbox](https:\u002F\u002Fgithub.com\u002FGerharddc\u002Flitterbox).\n\n---\n\n# Quick Start\n\n**Create a new distrobox:**\n\n`distrobox create -n test`\n\n**Create a new distrobox with Systemd (acts similar to an LXC):**\n\n`distrobox create --name test --init --image debian:latest --additional-packages \"systemd libpam-systemd pipewire-audio-client-libraries\"`\n\n**Enter created distrobox:**\n\n`distrobox enter test`\n\n**Add one with a [different distribution](https:\u002F\u002Fgithub.com\u002F89luca89\u002Fdistrobox\u002Fblob\u002Fmain\u002Fdocs\u002Fcompatibility.md#host-distros),\ne.g. Ubuntu 20.04:**\n\n`distrobox create -i ubuntu:20.04`\n\n**Execute a command in a distrobox:**\n\n`distrobox enter test -- command-to-execute`\n\n**List running distroboxes:**\n\n`distrobox list`\n\n**Stop a running distrobox:**\n\n`distrobox stop test`\n\n**Remove a distrobox:**\n\n`distrobox rm test`\n\nYou can check [HERE for more advanced usage](usage\u002Fusage.md)\nand check a [comprehensive list of useful tips HERE](useful_tips.md).\n\n# Assemble Distrobox\n\nManifest files can be used to declare a set of distroboxes and use\n`distrobox-assemble` to create\u002Fdestroy them in batch.\n\nHead over the [usage docs of distrobox-assemble](usage\u002Fdistrobox-assemble.md)\nfor a more detailed guide.\n\n# Configure Distrobox\n\nConfiguration files can be placed in the following paths, from the least important\nto the most important:\n\n- \u002Fusr\u002Fshare\u002Fdistrobox\u002Fdistrobox.conf\n- \u002Fusr\u002Fetc\u002Fdistrobox\u002Fdistrobox.conf\n- \u002Fetc\u002Fdistrobox\u002Fdistrobox.conf\n- ${HOME}\u002F.config\u002Fdistrobox\u002Fdistrobox.conf\n- ${HOME}\u002F.distroboxrc\n\nYou can specify inside distrobox configurations and distrobox-specific Environment\nvariables.\n\nExample configuration file:\n\n```conf\ncontainer_always_pull=\"1\"\ncontainer_generate_entry=0\ncontainer_manager=\"docker\"\ncontainer_image_default=\"registry.opensuse.org\u002Fopensuse\u002Ftoolbox:latest\"\ncontainer_name_default=\"test-name-1\"\ncontainer_user_custom_home=\"$HOME\u002F.local\u002Fshare\u002Fcontainer-home-test\"\ncontainer_init_hook=\"~\u002F.local\u002Fdistrobox\u002Fa_custom_default_init_hook.sh\"\ncontainer_pre_init_hook=\"~\u002Fa_custom_default_pre_init_hook.sh\"\ncontainer_manager_additional_flags=\"--env-file \u002Fpath\u002Fto\u002Ffile --custom-flag\"\ncontainer_additional_volumes=\"\u002Fexample:\u002Fexample1 \u002Fexample2:\u002Fexample3:ro\"\nnon_interactive=\"1\"\nskip_workdir=\"0\"\nPATH=\"$PATH:\u002Fpath\u002Fto\u002Fcustom\u002Fpodman\"\n```\n\nAlternatively, it is possible to specify preferences using ENV variables:\n\n- DBX_CONTAINER_ALWAYS_PULL\n- DBX_CONTAINER_CUSTOM_HOME\n- DBX_CONTAINER_IMAGE\n- DBX_CONTAINER_MANAGER\n- DBX_CONTAINER_NAME\n- DBX_CONTAINER_ENTRY\n- DBX_NON_INTERACTIVE\n- DBX_SKIP_WORKDIR\n\n---\n\n# Installation\n\nDistrobox is packaged in the following distributions, if your distribution is\non this list, you can refer to your repos for installation:\n\n[![Packaging status](https:\u002F\u002Frepology.org\u002Fbadge\u002Fvertical-allrepos\u002Fdistrobox.svg)](https:\u002F\u002Frepology.org\u002Fproject\u002Fdistrobox\u002Fversions)\n\nThanks to the maintainers for their work: [M0Rf30](https:\u002F\u002Fgithub.com\u002FM0Rf30),\n[alcir](https:\u002F\u002Fgithub.com\u002Falcir), [dfaggioli](https:\u002F\u002Fgithub.com\u002Fdfaggioli),\n[AtilaSaraiva](https:\u002F\u002Fgithub.com\u002FAtilaSaraiva), [michel-slm](https:\u002F\u002Fgithub.com\u002Fmichel-slm)\n\n## Alternative methods\n\nHere is a list of alternative ways to install `distrobox`.\n\n### Curl or Wget\n\nIf you like to live your life dangerously, or you want the latest release,\nyou can trust me and simply run this in your terminal:\n\n```sh\ncurl -s https:\u002F\u002Fraw.githubusercontent.com\u002F89luca89\u002Fdistrobox\u002Fmain\u002Finstall | sudo sh\n```\n\nor using wget\n\n```sh\nwget -qO- https:\u002F\u002Fraw.githubusercontent.com\u002F89luca89\u002Fdistrobox\u002Fmain\u002Finstall | sudo sh\n```\n\nor if you want to select a custom directory to install without sudo:\n\n```sh\ncurl -s https:\u002F\u002Fraw.githubusercontent.com\u002F89luca89\u002Fdistrobox\u002Fmain\u002Finstall | sh -s -- --prefix ~\u002F.local\n```\n\nor using wget\n\n```sh\nwget -qO- https:\u002F\u002Fraw.githubusercontent.com\u002F89luca89\u002Fdistrobox\u002Fmain\u002Finstall | sh -s -- --prefix ~\u002F.local\n```\n\nIf you want to install the last development version, directly from the last commit on Git, you can use:\n\n```sh\ncurl -s https:\u002F\u002Fraw.githubusercontent.com\u002F89luca89\u002Fdistrobox\u002Fmain\u002Finstall | sudo sh -s -- --next\n```\n\nor using wget\n\n```sh\nwget -qO- https:\u002F\u002Fraw.githubusercontent.com\u002F89luca89\u002Fdistrobox\u002Fmain\u002Finstall | sudo sh -s -- --next\n```\n\nor:\n\n```sh\ncurl -s https:\u002F\u002Fraw.githubusercontent.com\u002F89luca89\u002Fdistrobox\u002Fmain\u002Finstall | sh -s -- --next --prefix ~\u002F.local\n```\n\nor using wget\n\n```sh\nwget -qO- https:\u002F\u002Fraw.githubusercontent.com\u002F89luca89\u002Fdistrobox\u002Fmain\u002Finstall | sh -s -- --next --prefix ~\u002F.local\n```\n\n### Upgrading\n\nJust run the `curl` or `wget` command again.\n\n> [!WARNING]\n> Remember to add prefix-path-you-choose\u002Fbin to your PATH, to make it work.\n\n### Git\n\nAlternatively, you can clone the project using `git clone` or using the latest\nrelease [HERE](https:\u002F\u002Fgithub.com\u002F89luca89\u002Fdistrobox\u002Freleases\u002Flatest).\n\nEnter the directory and run `.\u002Finstall`, by default it will attempt to install\nin `~\u002F.local` but if you run the script as root, it will default to `\u002Fusr\u002Flocal`.\nYou can specify a custom directory with the `--prefix` flag\nsuch as `.\u002Finstall --prefix ~\u002F.distrobox`.\n\nPrefix explained: main distrobox files get installed to `${prefix}\u002Fbin` whereas\nthe man pages get installed to `${prefix}\u002Fshare\u002Fman`.\n\n---\n\nCheck the [Host Distros](compatibility.md#host-distros) compatibility list for\ndistro-specific instructions.\n\n## Dependencies\n\nDistrobox depends on a container manager to work, you can choose to install\neither `podman`, `docker` or [`lilipod`](https:\u002F\u002Fgithub.com\u002F89luca89\u002Flilipod).\n\nPlease look in the [Compatibility Table](compatibility.md#host-distros) for your\ndistribution notes.\n\nThere are ways to install\n[Podman without root privileges and in home](compatibility.md#install-podman-in-a-static-manner). Or\n[Lilipod without root privileges and in home](compatibility.md#install-lilipod-in-a-static-manner).\nThis should play well with completely sudoless setups and with devices like the Steam Deck (SteamOS).\n\n---\n\n## Uninstallation\n\nIf you installed `distrobox` using the `install` script in the default install\ndirectory use this:\n\n```sh\ncurl -s https:\u002F\u002Fraw.githubusercontent.com\u002F89luca89\u002Fdistrobox\u002Fmain\u002Funinstall | sudo sh\n```\n\nor if you specified a custom path:\n\n```sh\ncurl -s https:\u002F\u002Fraw.githubusercontent.com\u002F89luca89\u002Fdistrobox\u002Fmain\u002Funinstall | sh -s -- --prefix ~\u002F.local\n```\n\nElse, if you cloned the project using `git clone` or using the latest archive release\nfrom [HERE](https:\u002F\u002Fgithub.com\u002F89luca89\u002Fdistrobox\u002Freleases\u002Flatest),\n\nenter the directory and run `.\u002Funinstall`, by default it will assume the installation\ndirectory was `\u002Fusr\u002Flocal` if ran as root or `~\u002F.local`,\nyou can specify another directory if needed with `.\u002Funinstall --prefix ~\u002F.local`\n\n---\n\n![distro-box](.\u002Fassets\u002Fdistro-box.webp)\n\n\u003Csub>This artwork uses [Cardboard Box](https:\u002F\u002Fskfb.ly\u002F6Wq6q) model by [J0Y](https:\u002F\u002Fsketchfab.com\u002Flloydrostek)\nlicensed under [Creative Commons Attribution 4.0](http:\u002F\u002Fcreativecommons.org\u002Flicenses\u002Fby\u002F4.0)  \nThis artwork uses [GTK Loop Animation](https:\u002F\u002Fgithub.com\u002Fgnome-design-team\u002Fgnome-mockups\u002Fblob\u002Fmaster\u002Fgtk\u002Floop6.blend)\nby [GNOME Project](https:\u002F\u002Fwww.gnome.org)\nlicensed under [Creative Commons Attribution-ShareAlike 3.0](https:\u002F\u002Fcreativecommons.org\u002Flicenses\u002Fby-sa\u002F3.0)\nas a pre-configured scene\u003Csub>\n","Distrobox 是一个让你在终端中使用任何 Linux 发行版的工具。它通过 `podman`、`docker` 或 `lilipod` 创建容器，允许用户选择自己熟悉的发行版，并实现与主机系统的深度集成，包括共享用户的 HOME 目录、外部存储设备、USB 设备以及图形界面和音频应用的支持。此项目特别适合需要在同一台机器上运行多个不同 Linux 环境的开发者或系统管理员使用，无论是为了软件兼容性测试还是个人偏好。基于 Shell 语言开发，遵循 GNU General Public License v3.0 许可协议。",2,"2026-06-11 03:25:56","top_topic"]