1toolbox-enter(1)() toolbox-enter(1)()
2
3
4
6 toolbox-enter - Enter a toolbox container for interactive use
7
8
10 toolbox enter [--distro DISTRO | -d DISTRO]
11 [--release RELEASE | -r RELEASE]
12 [CONTAINER]
13
14
16 Spawns an interactive shell inside a toolbox container that was created
17 using the toolbox create command. It tries to spawn the user's default
18 shell, but if it's not available inside the container then it falls
19 back to /bin/bash.
20
21
22 When invoked without any options, toolbox enter will try to enter the
23 default toolbox container for the host, or if there's only one con‐
24 tainer available then it will use it. On Fedora, the default container
25 is known as fedora-toolbox-N, where N is the release of the host. If
26 there aren't any containers, toolbox enter will offer to create the
27 default one for you.
28
29
30 A specific container can be selected using the CONTAINER argument.
31
32
33 A toolbox container is an OCI container. Therefore, toolbox enter is
34 analogous to a podman start followed by a podman exec.
35
36
38 The following options are understood:
39
40
41 --distro DISTRO, -d DISTRO
42
43
44 Enter a toolbox container for a different operating system DISTRO than
45 the host.
46
47
48 --release RELEASE, -r RELEASE
49
50
51 Enter a toolbox container for a different operating system RELEASE than
52 the host.
53
54
56 Enter a toolbox container using the default image matching the host OS
57 $ toolbox enter
58
59
60
61 Enter a toolbox container using the default image for Fedora 30
62 $ toolbox enter --distro fedora --release f30
63
64
65
66 Enter a custom toolbox container using a custom image
67 $ toolbox enter foo
68
69
70
72 buildah(1), podman(1), podman-exec(1), podman-start(1)
73
74
75
76 toolbox-enter(1)()