.nh

.SH containers-storage-create-container 1 "August 2016"
.SH NAME
.PP
containers-storage create-container - Create a container

.SH SYNOPSIS
.PP
\fBcontainers-storage\fP \fBcreate-container\fP [\fIoptions\fP\&...] \fIimageNameOrID\fP

.SH DESCRIPTION
.PP
Creates a container, using the specified image as the starting point for its
root filesystem.

.SH OPTIONS
.PP
\fB-n | --name\fP \fIname\fP

.PP
Sets an optional name for the container.  If a name is already in use, an error
is returned.

.PP
\fB-i | --id\fP \fIID\fP

.PP
Sets the ID for the container.  If none is specified, one is generated.

.PP
\fB-m | --metadata\fP \fImetadata-value\fP

.PP
Sets the metadata for the container to the specified value.

.PP
\fB-f | --metadata-file\fP \fImetadata-file\fP

.PP
Sets the metadata for the container to the contents of the specified file.

.SH EXAMPLE
.PP
\fBcontainers-storage create-container -f manifest.json -n new-container goodimage\fP

.SH SEE ALSO
.PP
containers-storage-create-image(1)
containers-storage-create-layer(1)
containers-storage-delete-container(1)