.nh
.TH toolbox-enter 1
.SH NAME
.PP
toolbox-enter - Enter a toolbox container for interactive use

.SH SYNOPSIS
.PP
\fBtoolbox enter\fP [\fI--distro DISTRO\fP | \fI-d DISTRO\fP]
              [\fI--release RELEASE\fP | \fI-r RELEASE\fP]
              [\fICONTAINER\fP]

.SH DESCRIPTION
.PP
Spawns an interactive shell inside a toolbox container that was created using
the \fB\fCtoolbox create\fR command. It tries to spawn the user's default shell, but
if it's not available inside the container then it falls back to \fB\fC/bin/bash\fR\&.

.PP
When invoked without any options, \fB\fCtoolbox enter\fR 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
\fB\fCfedora-toolbox-N\fR, where N is the release of the host. If there aren't any
containers, \fB\fCtoolbox enter\fR will offer to create the default one for you.

.PP
A specific container can be selected using the CONTAINER argument.

.PP
A toolbox container is an OCI container. Therefore, \fB\fCtoolbox enter\fR is
analogous to a \fB\fCpodman start\fR followed by a \fB\fCpodman exec\fR\&.

.SH OPTIONS
.PP
The following options are understood:

.PP
\fB--distro\fP DISTRO, \fB-d\fP DISTRO

.PP
Enter a toolbox container for a different operating system DISTRO than the
host. Has to be coupled with \fB\fC--release\fR unless the selected DISTRO matches the
host.

.PP
\fB--release\fP RELEASE, \fB-r\fP RELEASE

.PP
Enter a toolbox container for a different operating system RELEASE than the
host.

.SH EXAMPLES
.SS Enter a toolbox container using the default image matching the host OS
.PP
.RS

.nf
$ toolbox enter

.fi
.RE

.SS Enter a toolbox container using the default image for Fedora 36
.PP
.RS

.nf
$ toolbox enter --distro fedora --release f36

.fi
.RE

.SS Enter a custom toolbox container using a custom image
.PP
.RS

.nf
$ toolbox enter foo

.fi
.RE

.SH SEE ALSO
.PP
\fB\fCtoolbox(1)\fR, \fB\fCtoolbox-run(1)\fR, \fB\fCpodman(1)\fR, \fB\fCpodman-exec(1)\fR,
\fB\fCpodman-start(1)\fR