1toolbox-create(1)()                                        toolbox-create(1)()
2
3
4

NAME

6       toolbox-create - Create a new toolbox container
7
8

SYNOPSIS

10       toolbox create [--candidate-registry]
11                      [--container NAME | -c NAME]
12                      [--image NAME | -i NAME]
13                      [--release RELEASE | -r RELEASE]
14
15

DESCRIPTION

17       Creates  a  new  toolbox  container. You can then use the toolbox enter
18       command to interact with the container at any point.
19
20
21       A toolbox container is an OCI container created from an OCI  image.  On
22       Fedora  the  base image is known as fedora-toolbox. If the image is not
23       present locally, then it is pulled from registry.fedoraproject.org. The
24       base  image is locally customized for the current user to create a sec‐
25       ond image, from which the container is finally created.
26
27
28       Toolbox containers and images are tagged with the  version  of  the  OS
29       that  corresponds  to the content inside them. The user-specific images
30       and the toolbox containers are prefixed with the name of the base image
31       and suffixed with the current user name.
32
33

OPTIONS

35       The following options are understood:
36
37
38       --candidate-registry
39
40
41       Pull  the base image from candidate-registry.fedoraproject.org. This is
42       useful for testing newly built images before they  have  moved  to  the
43       stable registry at registry.fedoraproject.org.
44
45
46       --container NAME, -c NAME
47
48
49       Assign  a  different  NAME to the toolbox container. This is useful for
50       creating multiple toolbox containers from the same base image,  or  for
51       entirely customized containers from custom-built base images.
52
53
54       --image NAME, -i NAME
55
56
57       Change the NAME of the base image used to create the toolbox container.
58       This is useful for creating containers from custom-built base images.
59
60
61       --release RELEASE, -r RELEASE
62
63
64       Create a toolbox container for a  different  operating  system  RELEASE
65       than the host.
66
67

EXAMPLES

69   Create a toolbox container using the default image matching the host OS
70              $ toolbox create
71
72
73
74   Create a toolbox container using the default image for Fedora 30
75              $ toolbox create --release f30
76
77
78
79   Create a custom toolbox container from a custom image
80              $ toolbox create --container foo --image bar
81
82
83
84   Create a toolbox using images from the unstable candidate registry
85              $ toolbox create --candidate-registry
86
87
88

SEE ALSO

90       buildah(1), podman(1)
91
92
93
94                                                           toolbox-create(1)()
Impressum