af87ede1db
The --candidate-registry is a lesser known option only supported by the POSIX shell implementation. The Go never implementation never offered it, and nobody has felt its absence so far. So, it's safe to assume that there's no urgent need to port it to Go, and it's better to not confuse users by mentioning it. https://github.com/containers/toolbox/pull/662
2 KiB
% toolbox-create(1)
NAME
toolbox-create - Create a new toolbox container
SYNOPSIS
toolbox create [--container NAME | -c NAME] [--image NAME | -i NAME] [--release RELEASE | -r RELEASE]
DESCRIPTION
Creates a new toolbox container. You can then use the toolbox enter command
to interact with the container at any point.
A toolbox container is an OCI container created from an OCI image. On Fedora
the base image is known as fedora-toolbox. If the image is not present
locally, then it is pulled from registry.fedoraproject.org. The base image is
locally customized for the current user to create a second image, from which
the container is finally created.
Toolbox containers and images are tagged with the version of the OS that corresponds to the content inside them. The user-specific images and the toolbox containers are prefixed with the name of the base image and suffixed with the current user name.
OPTIONS
The following options are understood:
--container NAME, -c NAME
Assign a different NAME to the toolbox container. This is useful for creating multiple toolbox containers from the same base image, or for entirely customized containers from custom-built base images.
--image NAME, -i NAME
Change the NAME of the base image used to create the toolbox container. This
is useful for creating containers from custom-built base images. Cannot be used
used with --release.
--release RELEASE, -r RELEASE
Create a toolbox container for a different operating system RELEASE than the
host. Cannot be used with --image.
EXAMPLES
Create a toolbox container using the default image matching the host OS
$ toolbox create
Create a toolbox container using the default image for Fedora 30
$ toolbox create --release f30
Create a custom toolbox container from a custom image
$ toolbox create --container foo --image bar
SEE ALSO
buildah(1), podman(1)