1toolbox-create(1)           General Commands Manual          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
25       second 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