1toolbox(1)()                                                      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 Sil‐
25       verblue.  The intention of these systems is to discourage  installation
26       of  software  on the host, and instead install software as (or in) con‐
27       tainers.
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 containeriza‐
33       tion.
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 including standard  error  stream  of  internal
62       commands.  Use -vv for more detail.
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-help(1)
82
83
84       Display help information about Toolbox.
85
86
87       toolbox-init-container(1)
88
89
90       Initialize a running container.
91
92
93       toolbox-list(1)
94
95
96       List existing toolbox containers and images.
97
98
99       toolbox-reset(1)
100
101
102       Remove all local podman (and toolbox) state.
103
104
105       toolbox-rm(1)
106
107
108       Remove one or more toolbox containers.
109
110
111       toolbox-rmi(1)
112
113
114       Remove one or more toolbox images.
115
116
117       toolbox-run(1)
118
119
120       Run a command in an existing toolbox container.
121
122

SEE ALSO

124       buildah(1), podman(1)
125
126
127
128                                                                  toolbox(1)()
Impressum