1toolbox-run(1)()                                              toolbox-run(1)()
2
3
4

NAME

6       toolbox-run - Run a command in an existing toolbox container
7
8

SYNOPSIS

10       toolbox run [--container NAME | -c NAME]
11                   [--distro DISTRO | -d DISTRO]
12                   [--release RELEASE | -r RELEASE]
13                   [COMMAND]
14
15

DESCRIPTION

17       Runs  a  command  inside  an  existing toolbox container. The container
18       should have been created using the toolbox create command.
19
20
21       On Fedora, the default container is known as fedora-toolbox-N, where  N
22       is  the release of the host. A specific container can be selected using
23       the --container option.
24
25
26       A toolbox container is an OCI  container.  Therefore,  toolbox  run  is
27       analogous to a podman start followed by a podman exec.
28
29

OPTIONS

31       The following options are understood:
32
33
34       --container NAME, -c NAME
35
36
37       Run  command  inside  a  toolbox container with the given NAME. This is
38       useful when there are multiple toolbox containers created from the same
39       base image, or entirely customized containers created from custom-built
40       base images.
41
42
43       --distro DISTRO, -d DISTRO
44
45
46       Run command inside a toolbox container for a different operating system
47       DISTRO than the host.
48
49
50       --release RELEASE, -r RELEASE
51
52
53       Run command inside a toolbox container for a different operating system
54       RELEASE than the host.
55
56

EXAMPLES

58   Run ls inside a toolbox container using the default image matching the host
59       OS
60              $ toolbox run ls -la
61
62
63
64   Run emacs inside a toolbox container using the default image for Fedora 30
65              $ toolbox run --distro fedora --release f30 emacs
66
67
68
69   Run uptime inside a custom toolbox container using a custom image
70              $ toolbox run --container foo uptime
71
72
73

SEE ALSO

75       toolbox(1), podman(1), podman-exec(1), podman-start(1)
76
77
78
79                                                              toolbox-run(1)()
Impressum