1DISTROBOX(1) User Manual DISTROBOX(1)
2
3
4
6 This project does not need a dedicated image. It can use any OCI im‐
7 ages from docker-hub, quay.io, or any registry of your choice.
8
9 Granted, they may not be as featureful as expected (some of them do not
10 even have which, mount, less or vi) but that’s all doable in the con‐
11 tainer itself after bootstrapping it.
12
13 The main concern is having basic Linux utilities (mount), basic user
14 management utilities (usermod, passwd), and sudo correctly set.
15
16 Supported container managers
17 distrobox can run on either podman or docker
18
19 It depends either on podman configured in rootless mode or on docker
20 configured without sudo (follow THIS instructions (https://docs.dock‐
21 er.com/engine/install/linux-postinstall/))
22
23 • Minimum podman version: 2.1.0
24
25 • Minimum docker version: 18.06.1
26
27 Follow the official installation guide here:
28
29 • <https://podman.io/getting-started/installation>
30
31 • <https://docs.docker.com/engine/install>
32
33 • <https://docs.docker.com/engine/install/linux-postinstall/>
34
35 Containers Distros
36 Distrobox guests tested successfully with the following container im‐
37 ages:
38
39 Distro Version Images
40 ─────────────────────────────────────────────────────────────────────────────
41 AlmaLinux 8 8-minimal 9 9-minimal docker.io/library/alma‐
42 linux:8 docker.io/li‐
43 brary/almalinux:9 dock‐
44 er.io/library/almalin‐
45 ux:9-minimal
46 AlmaLinux (UBI) 8 docker.io/almalin‐
47 ux/8-base docker.io/al‐
48 malinux/8-init
49 Alpine Linux 3.14 3.15 docker.io/li‐
50 brary/alpine:latest
51 AmazonLinux 2 docker.io/library/ama‐
52 zonlinux:2.0.20211005.0
53 AmazonLinux 2022 public.ecr.aws/amazon‐
54 linux/amazonlinux:2022
55 Archlinux docker.io/library/arch‐
56 linux:latest
57 ClearLinux docker.io/li‐
58 brary/clearlinux:latest
59 docker.io/li‐
60 brary/clearlinux:base
61 CentOS 7 quay.io/centos/centos:7
62 CentOS Stream 8 9 quay.io/centos/cen‐
63 tos:stream8
64 quay.io/centos/cen‐
65 tos:stream9
66
67 RedHat (UBI) 7 8 9 registry.access.red‐
68 hat.com/ubi7/ubi reg‐
69 istry.access.red‐
70 hat.com/ubi7/ubi-init
71 registry.access.red‐
72 hat.com/ubi7/ubi-mini‐
73 mal registry.ac‐
74 cess.red‐
75 hat.com/ubi8/ubi reg‐
76 istry.access.red‐
77 hat.com/ubi8/ubi-init
78 registry.access.red‐
79 hat.com/ubi8/ubi-mini‐
80 mal registry.ac‐
81 cess.red‐
82 hat.com/ubi9/ubi reg‐
83 istry.access.red‐
84 hat.com/ubi9/ubi-init
85 registry.access.red‐
86 hat.com/ubi9/ubi-mini‐
87 mal
88 Debian 7 8 9 10 11 docker.io/de‐
89 bian/eol:wheezy dock‐
90 er.io/library/debian:8
91 docker.io/library/de‐
92 bian:9 docker.io/li‐
93 brary/debian:10 dock‐
94 er.io/library/de‐
95 bian:stable dock‐
96 er.io/library/de‐
97 bian:stable-backports
98 Debian Testing docker.io/library/de‐
99 bian:testing dock‐
100 er.io/library/de‐
101 bian:testing-backports
102 Debian Unstable docker.io/library/de‐
103 bian:unstable
104 Neurodebian nd100 docker.io/library/neu‐
105 rodebian:nd100
106 Fedora 34 35 36 37 Rawhide registry.fedorapro‐
107 ject.org/fedora-tool‐
108 box:34 docker.io/li‐
109 brary/fedora:34 reg‐
110 istry.fedorapro‐
111 ject.org/fedora-tool‐
112 box:35 docker.io/li‐
113 brary/fedora:35 dock‐
114 er.io/library/fedora:36
115 registry.fedorapro‐
116 ject.org/fedora:37
117 docker.io/library/fedo‐
118 ra:rawhide
119 Mageia 8 docker.io/li‐
120 brary/mageia
121 Opensuse Leap registry.open‐
122 suse.org/open‐
123 suse/leap:latest
124 Opensuse Tumbleweed registry.open‐
125 suse.org/opensuse/tum‐
126 bleweed:latest reg‐
127 istry.open‐
128 suse.org/opensuse/tool‐
129 box:latest
130
131
132
133 Oracle Linux 7 8 container-registry.ora‐
134 cle.com/os/oraclelin‐
135 ux:7 container-reg‐
136 istry.oracle.com/os/or‐
137 aclelinux:8
138 Rocky Linux 8 docker.io/rockylin‐
139 ux/rockylinux:8
140 Scientific Linux 7 docker.io/library/sl:7
141 Slackware 14.2 docker.io/vbatts/slack‐
142 ware:14.2
143 Ubuntu 14.04 16.04 18.04 20.04 docker.io/library/ubun‐
144 21.10 22.04 tu:14.04 docker.io/li‐
145 brary/ubuntu:16.04
146 docker.io/library/ubun‐
147 tu:18.04 docker.io/li‐
148 brary/ubuntu:20.04
149 docker.io/library/ubun‐
150 tu:21.10 docker.io/li‐
151 brary/ubuntu:22.04
152 Kali Linux rolling docker.io/kalilin‐
153 ux/kali-rolling:latest
154 Void Linux ghcr.io/void-lin‐
155 ux/void-linux:latest-
156 full-x86_64
157 ghcr.io/void-lin‐
158 ux/void-linux:latest-
159 full-x86_64-musl
160 Gentoo Linux rolling You will have to Build
161 your own to have a com‐
162 plete Gentoo docker im‐
163 age
164
165 Note however that if you use a non-toolbox preconfigured image (e.g.
166 images pre-baked to work with <https://github.com/containers/toolbox),>
167 the first distrobox-enter you’ll perform can take a while as it will
168 download and install the missing dependencies.
169
170 A small time tax to pay for the ability to use any type of image. This
171 will not occur after the first time, subsequent enters will be much
172 faster.
173
174 NixOS is not a supported container distro, and there are currently no
175 plans to bring support to it. If you are looking for unprivlaged NixOS
176 environments, we suggest you look into nix-shell
177 (https://nixos.org/manual/nix/unstable/command-ref/nix-shell.html).
178
179 New Distro support
180 If your distro of choice is not on the list, open an issue requesting
181 support for it, we can work together to check if it is possible to add
182 support for it.
183
184 Or just try using it anyway, if it works, open an issue and it will be
185 added to the list!
186
187 Older distributions
188 For older distributions like CentOS 5, CentOS 6, Debian 6, Ubuntu
189 12.04, compatibility is not assured.
190
191 Their libc version is incompatible with kernel releases after >=4.11.
192 A work around this is to use the vsyscall=emulate flag in the bootload‐
193 er of the host.
194
195 Keep also in mind that mirrors could be down for such old releases, so
196 you will need to build a custom distrobox image to ensure basic depen‐
197 dencies are met.
198
199
200
201Distrobox Jun 2022 DISTROBOX(1)