1toolbox-run(1)() toolbox-run(1)()
2
3
4
6 toolbox-run - Run a command in an existing toolbox container
7
8
10 toolbox run [--container NAME | -c NAME]
11 [--distro DISTRO | -d DISTRO]
12 [--release RELEASE | -r RELEASE] [COMMAND]
13
14
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
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
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
75 buildah(1), podman(1), podman-exec(1), podman-start(1)
76
77
78
79 toolbox-run(1)()