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] [COMMAND]
13
14

DESCRIPTION

16       Runs  a  command  inside  an  existing toolbox container. The container
17       should have been created using the toolbox create command.
18
19
20       A toolbox container is an OCI  container.  Therefore,  toolbox  run  is
21       analogous to a podman start followed by a podman exec.
22
23
24       By  default,  the toolbox containers are tagged with the version of the
25       OS that corresponds to the content inside them. Their  names  are  pre‐
26       fixed  with  the  name  of the base image and suffixed with the current
27       user name.
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       buildah(1), podman(1), podman-exec(1), podman-start(1)
76
77
78
79                                                              toolbox-run(1)()
Impressum