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                   [--release RELEASE | -r RELEASE] [COMMAND]
12
13

DESCRIPTION

15       Runs  a  command  inside  an  existing toolbox container. The container
16       should have been created using the toolbox create command.
17
18
19       A toolbox container is an OCI  container.  Therefore,  toolbox  run  is
20       analogous to a podman start followed by a podman exec.
21
22
23       On  Fedora the toolbox containers are tagged with the version of the OS
24       that corresponds to the content inside them. Their names  are  prefixed
25       with  the  name  of  the  base image and suffixed with the current user
26       name.
27
28

OPTIONS

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

EXAMPLES

50   Run ls inside a toolbox container using the default image matching the host
51       OS
52              $ toolbox run ls -la
53
54
55
56   Run emacs inside a toolbox container using the default image for Fedora 30
57              $ toolbox run --release f30 emacs
58
59
60
61   Run uptime inside a custom toolbox container using a custom image
62              $ toolbox run --container foo uptime
63
64
65

SEE ALSO

67       buildah(1), podman(1), podman-exec(1), podman-start(1)
68
69
70
71                                                              toolbox-run(1)()
Impressum