1toolbox.conf(5)               File Formats Manual              toolbox.conf(5)
2
3
4

NAME

6       toolbox.conf - Toolbox configuration file
7
8

DESCRIPTION

10       Persistently  overrides the default behaviour of toolbox(1). The syntax
11       is TOML and the names of the options match their command line  counter‐
12       parts.  Currently, the only supported section is general.
13
14

OPTIONS

16       distro = "DISTRO"
17
18
19       Create a toolbox container for a different operating system DISTRO than
20       the host. Cannot be used with image.
21
22
23       image = "NAME"
24
25
26       Change the NAME of the image used to create the toolbox container. This
27       is  useful  for creating containers from custom-built images. Cannot be
28       used with distro and release.
29
30
31       If NAME does not contain a registry, the local image  storage  will  be
32       consulted,  and if it's not present there then it will be pulled from a
33       suitable remote registry.
34
35
36       release = "RELEASE"
37
38
39       Create a toolbox container for a  different  operating  system  RELEASE
40       than the host. Cannot be used with image.
41
42

FILES

44       The following locations are looked up in increasing order of priority:
45
46
47       /etc/containers/toolbox.conf
48
49
50       This is meant to be provided by the operating system distributor or the
51       system administrator, and affects all users on the host.
52
53
54       Fields specified here can be overridden by any of the files below.
55
56
57       $XDG_CONFIG_HOME/containers/toolbox.conf
58
59
60       This is meant for user-specific changes. Fields specified here override
61       any of the files above.
62
63

EXAMPLES

65   Override the default operating system distro:
66       [general]
67       distro = "fedora"
68       release = "36"
69
70
71
72   Override the default image:
73       [general]
74       image = "registry.fedoraproject.org/fedora-toolbox:36"
75
76
77

SEE ALSO

79       toolbox(1), toolbox-create(1)
80
81
82
83                                                               toolbox.conf(5)
Impressum