.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)