toolbox-enter - Enter a toolbox container for interactive use
Contents
Description
Spawns an interactive shell inside a toolbox container that was created using the toolboxcreate 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, toolboxenter 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, toolboxenter 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, toolboxenter is analogous to a podmanstart followed
by a podmanexec.
Examples
EnteratoolboxcontainerusingthedefaultimagematchingthehostOS
$ toolbox enter
EnteratoolboxcontainerusingthedefaultimageforFedora36
$ toolbox enter --distro fedora --release f36
Enteracustomtoolboxcontainerusingacustomimage
$ toolbox enter foo
Name
toolbox-enter - Enter a toolbox container for interactive use
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.
See Also
toolbox(1), toolbox-run(1), podman(1), podman-exec(1), podman-start(1)toolbox-enter(1)
Synopsis
toolboxenter [--distroDISTRO | -dDISTRO]
[--releaseRELEASE | -rRELEASE]
[CONTAINER]
