NAME

       toolbox-run - Run a command in an existing toolbox container

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 base image, or entirely customized
       containers created from custom-built base 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 30
              $ toolbox run --distro fedora --release f30 emacs

   Run uptime inside a custom toolbox container using a custom image
              $ toolbox run --container foo uptime

SEE ALSO

       toolbox(1), podman(1), podman-exec(1), podman-start(1)

                                                                                 toolbox-run(1)()