1toolbox-run(1)              General Commands Manual             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