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