1DISTROBOX-ENTER(1)                User Manual               DISTROBOX-ENTER(1)
2
3
4

Enter the distrobox

6       distrobox-enter  takes  care  of  entering  the container with the name
7       specified.  Default command executed is your SHELL, but you can specify
8       different  shells  or entire commands to execute.  If using it inside a
9       script, an application, or a service, you  can  specify  the  –headless
10       mode to disable tty and interactivity.
11
12       Usage:
13
14              distrobox-enter --name fedora-toolbox-35 -- bash -l
15              distrobox-enter my-alpine-container -- sh -l
16              distrobox-enter --additional-flags "--preserve-fds" --name test -- bash -l
17              distrobox-enter --additional-flags "--env MY_VAR=value" --name test -- bash -l
18              MY_VAR=value distrobox-enter --additional-flags "--preserve-fds" --name test -- bash -l
19
20       You can also use environment variables to specify container manager and
21       container name:
22
23              DBX_CONTAINER_MANAGER="docker" DBX_CONTAINER_NAME=test-alpine distrobox-enter
24
25       Supported environment variables:
26
27              DBX_CONTAINER_NAME
28              DBX_CONTAINER_MANAGER
29              DBX_SKIP_WORKDIR
30
31       Options:
32
33              --name/-n:      name for the distrobox                      default: my-distrobox
34              --/-e:          end arguments execute the rest as command to execute at login   default: bash -l
35              --no-tty/-T:        do not instantiate a tty
36              --no-workdir/-nw:       always start the container from container's home directory
37              --additional-flags/-a:  additional flags to pass to the container manager command
38              --help/-h:      show this message
39              --root/-r:      launch podman/docker with root privileges. Note that if you need root this is the preferred
40                          way over "sudo distrobox"
41              --dry-run/-d:       only print the container manager command generated
42              --verbose/-v:       show more verbosity
43              --version/-V:       show version
44
45       This is used to enter the distrobox itself.  Personally, I just  create
46       multiple  profiles in my gnome-terminal to have multiple distros acces‐
47       sible.
48
49       The --additional-flags or -a is useful to modify default  command  when
50       executing in the container.  For example:
51
52              distrobox enter -n dev-arch --additional-flags "--env my_var=test" -- printenv &| grep my_var
53              my_var=test
54
55       This is possible also using normal env variables:
56
57              my_var=test distrobox enter -n dev-arch --additional-flags -- printenv &| grep my_var
58              my_var=test
59
60
61
62Distrobox                          Jun 2022                 DISTROBOX-ENTER(1)
Impressum