toolbox-run - Man Page
Run a command in an existing toolbox container
Examples (TL;DR)
- Run a command inside a specific
toolbox
container:toolbox run --container container_name command
- Run a command inside a
toolbox
container for a specific release of a distribution:toolbox run --distro distribution --release release command
- Run
emacs
inside atoolbox
container using the default image for Fedora 36:toolbox run --distro fedora --release f36 emacs
Synopsis
toolbox run [--container NAME | -c NAME]
[--distro DISTRO | -d DISTRO]
[--release RELEASE | -r RELEASE]
[COMMAND]
Description
Runs a command inside an existing toolbox container. The container should have been created using the toolbox create
command.
On Fedora, the default container is known as fedora-toolbox-N
, where N is the release of the host. A specific container can be selected using the --container
option.
A toolbox container is an OCI container. Therefore, toolbox run
is analogous to a podman start
followed by a podman exec
.
Options
The following options are understood:
- --container
- NAME, -c NAME
Run command inside a toolbox container with the given NAME. This is useful when there are multiple toolbox containers created from the same image, or entirely customized containers created from custom-built images.
- --distro
- DISTRO, -d DISTRO
Run command inside a toolbox container for a different operating system DISTRO than the host.
- --release
- RELEASE, -r RELEASE
Run command inside a toolbox container for a different operating system RELEASE than the host.
Examples
Run ls inside a toolbox container using the default image matching the host OS
$ toolbox run ls -la
Run emacs inside a toolbox container using the default image for Fedora 36
$ toolbox run --distro fedora --release f36 emacs
Run uptime inside a custom toolbox container using a custom image
$ toolbox run --container foo uptime