1toolbox(1)                  General Commands Manual                 toolbox(1)
2
3
4

NAME

6       toolbox - Unprivileged development environment
7
8

SYNOPSIS

10       toolbox [--verbose | -v] COMMAND [ARGS]
11
12

DESCRIPTION

14       Toolbox is a tool that offers a familiar RPM based environment for
15       developing and debugging software that runs fully unprivileged using
16       Podman.
17
18
19       The toolbox container is a fully mutable container; when you see yum
20       install ansible for example, that's something you can do inside your
21       toolbox container, without affecting the base operating system.
22
23
24       This is particularly useful on OSTree based Fedora systems like
25       Silverblue.  The intention of these systems is to discourage
26       installation of software on the host, and instead install software as
27       (or in) containers.
28
29
30       However this tool doesn't require using an OSTree based system — it
31       works equally well if you're running e.g. existing Fedora Workstation
32       or Server, and that's a useful way to incrementally adopt
33       containerization.
34
35
36       The toolbox environment is based on an OCI image. On Fedora this is the
37       fedora-toolbox image. This image is then customized for the current
38       user to create a toolbox container that seamlessly integrates with the
39       rest of the operating system.
40
41

OPTIONS

43       The following options are understood:
44
45
46       --assumeyes, -y
47
48
49       Automatically answer yes for all questions.
50
51
52       --help, -h
53
54
55       Print a synopsis of this manual and exit.
56
57
58       --verbose, -v
59
60
61       Print debug information. This includes messages coming from the
62       standard error stream of internal commands.
63
64

COMMANDS

66       Commands for working with toolbox containers and images:
67
68
69       toolbox-create(1)
70
71
72       Create a new toolbox container.
73
74
75       toolbox-enter(1)
76
77
78       Enter a toolbox container for interactive use.
79
80
81       toolbox-init-container(1)
82
83
84       Initialize a running container.
85
86
87       toolbox-list(1)
88
89
90       List existing toolbox containers and images.
91
92
93       toolbox-rm(1)
94
95
96       Remove one or more toolbox containers.
97
98
99       toolbox-rmi(1)
100
101
102       Remove one or more toolbox images.
103
104
105       toolbox-run(1)
106
107
108       Run a command in an existing toolbox container.
109
110

SEE ALSO

112       buildah(1), podman(1)
113
114
115
116                                                                    toolbox(1)
Impressum