ffd365342e
...unless the selected distro matches the host system. https://github.com/containers/toolbox/pull/977 https://github.com/containers/toolbox/pull/986
66 lines
1.8 KiB
Markdown
66 lines
1.8 KiB
Markdown
% toolbox-enter(1)
|
|
|
|
## NAME
|
|
toolbox\-enter - Enter a toolbox container for interactive use
|
|
|
|
## SYNOPSIS
|
|
**toolbox enter** [*--distro DISTRO* | *-d DISTRO*]
|
|
[*--release RELEASE* | *-r RELEASE*]
|
|
[*CONTAINER*]
|
|
|
|
## DESCRIPTION
|
|
|
|
Spawns an interactive shell inside a toolbox container that was created using
|
|
the `toolbox create` command. It tries to spawn the user's default shell, but
|
|
if it's not available inside the container then it falls back to `/bin/bash`.
|
|
|
|
When invoked without any options, `toolbox enter` will try to enter the default
|
|
toolbox container for the host, or if there's only one container available then
|
|
it will use it. On Fedora, the default container is known as
|
|
`fedora-toolbox-N`, where N is the release of the host. If there aren't any
|
|
containers, `toolbox enter` will offer to create the default one for you.
|
|
|
|
A specific container can be selected using the CONTAINER argument.
|
|
|
|
A toolbox container is an OCI container. Therefore, `toolbox enter` is
|
|
analogous to a `podman start` followed by a `podman exec`.
|
|
|
|
## OPTIONS ##
|
|
|
|
The following options are understood:
|
|
|
|
**--distro** DISTRO, **-d** DISTRO
|
|
|
|
Enter a toolbox container for a different operating system DISTRO than the
|
|
host. Has to be coupled with `--release` unless the selected DISTRO matches the
|
|
host.
|
|
|
|
**--release** RELEASE, **-r** RELEASE
|
|
|
|
Enter a toolbox container for a different operating system RELEASE than the
|
|
host.
|
|
|
|
## EXAMPLES
|
|
|
|
### Enter a toolbox container using the default image matching the host OS
|
|
|
|
```
|
|
$ toolbox enter
|
|
```
|
|
|
|
### Enter a toolbox container using the default image for Fedora 36
|
|
|
|
```
|
|
$ toolbox enter --distro fedora --release f36
|
|
```
|
|
|
|
### Enter a custom toolbox container using a custom image
|
|
|
|
```
|
|
$ toolbox enter foo
|
|
```
|
|
|
|
## SEE ALSO
|
|
|
|
`toolbox(1)`, `toolbox-run(1)`, `podman(1)`, `podman-exec(1)`,
|
|
`podman-start(1)`
|