toolbox(1)

1toolbox(1)()                                                      toolbox(1)()
2
3
4

NAME

6       toolbox - Tool for containerized command line environments on Linux
7
8

SYNOPSIS

10       toolbox [--assumeyes | -y]
11               [--help | -h]
12               [--log-level LEVEL]
13               [--log-podman]
14               [--verbose | -v]
15               COMMAND [ARGS...]
16
17

DESCRIPTION

19       Toolbox  is a tool for Linux operating systems, which allows the use of
20       containerized command line environments. It is built on top  of  Podman
21       and other standard container technologies from OCI.
22
23
24       This  is particularly useful on OSTree based operating systems like Fe‐
25       dora CoreOS and Silverblue. The intention of these systems is  to  dis‐
26       courage installation of software on the host, and instead install soft‐
27       ware as (or in) containers — they mostly don't even have  package  man‐
28       agers like DNF or YUM.  This makes it difficult to set up a development
29       environment or install tools for debugging in the usual way.
30
31
32       Toolbox solves this problem by  providing  a  fully  mutable  container
33       within  which one can install their favourite development and debugging
34       tools, editors and SDKs. For example, it's possible to do  yum  install
35       ansible without affecting the base operating system.
36
37
38       However,  this  tool  doesn't  require using an OSTree based system. It
39       works equally well on Fedora Workstation and Server, and that's a  use‐
40       ful way to incrementally adopt containerization.
41
42
43       The toolbox environment is based on an OCI image. On Fedora this is the
44       fedora-toolbox image. This image is used to create a toolbox  container
45       that  seamlessly  integrates  with  the rest of the operating system by
46       providing access to the user's home  directory,  the  Wayland  and  X11
47       sockets,  networking  (including  Avahi),  removable  devices (like USB
48       sticks), systemd journal, SSH agent, D-Bus, ulimits, /dev and the  udev
49       database, etc..
50
51

GLOBAL OPTIONS

53       The following options are understood:
54
55
56       --assumeyes, -y
57
58
59       Automatically answer yes for all questions.
60
61
62       --help, -h
63
64
65       Print a synopsis of this manual and exit.
66
67
68       --log-level=level
69
70
71       Log  messages above specified level: debug, info, warn, error, fatal or
72       panic (default: error)
73
74
75       --log-podman
76
77
78       Show log messages of invocations of Podman based on the  logging  level
79       specified by option log-level.
80
81
82       --verbose, -v
83
84
85       Same as --log-level=debug. Use -vv to include --log-podman.
86
87

COMMANDS

89       Commands for working with toolbox containers and images:
90
91
92       toolbox-create(1)
93
94
95       Create a new toolbox container.
96
97
98       toolbox-enter(1)
99
100
101       Enter a toolbox container for interactive use.
102
103
104       toolbox-help(1)
105
106
107       Display help information about Toolbox.
108
109
110       toolbox-init-container(1)
111
112
113       Initialize a running container.
114
115
116       toolbox-list(1)
117
118
119       List existing toolbox containers and images.
120
121
122       toolbox-rm(1)
123
124
125       Remove one or more toolbox containers.
126
127
128       toolbox-rmi(1)
129
130
131       Remove one or more toolbox images.
132
133
134       toolbox-run(1)
135
136
137       Run a command in an existing toolbox container.
138
139

NAME

SYNOPSIS

DESCRIPTION

GLOBAL OPTIONS

COMMANDS

SEE ALSO