1toolbox-enter(1)            General Commands Manual           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.  Has to be coupled with --release unless the selected DISTRO
46       matches the host.
47
48
49       --release RELEASE, -r RELEASE
50
51
52       Enter a toolbox container for a different operating system RELEASE than
53       the host.
54
55

EXAMPLES

57   Enter a toolbox container using the default image matching the host OS
58       $ toolbox enter
59
60
61
62   Enter a toolbox container using the default image for Fedora 36
63       $ toolbox enter --distro fedora --release f36
64
65
66
67   Enter a custom toolbox container using a custom image
68       $ toolbox enter foo
69
70
71

SEE ALSO

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