.nh
.TH containers-storage-create-container 1 "August 2016"
.SH NAME
containers-storage-create-container \- Create a container

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

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

.SH OPTIONS
\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
.EX
containers-storage create-container -f manifest.json -n new-container goodimage
.EE

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