1toolbox-enter(1)()                                          toolbox-enter(1)()
2
3
4

NAME

6       toolbox-enter - Enter a toolbox container for interactive use
7
8

SYNOPSIS

10       toolbox enter [--distro DISTRO | -d DISTRO]
11                     [--release RELEASE | -r RELEASE]
12                     [CONTAINER]
13
14

DESCRIPTION

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 de‐
27       fault 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

OPTIONS

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

EXAMPLES

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 36
62              $ toolbox enter --distro fedora --release f36
63
64
65
66   Enter a custom toolbox container using a custom image
67              $ toolbox enter foo
68
69
70

SEE ALSO

72       toolbox(1), toolbox-run(1), podman(1), podman-exec(1), podman-start(1)
73
74
75
76                                                            toolbox-enter(1)()
Impressum