.nh

.SH containers-storage-create-image 1 "August 2016"
.SH NAME
.PP
containers-storage create-image - Create an image

.SH SYNOPSIS
.PP
\fBcontainers-storage\fP \fBcreate-image\fP [\fIoptions\fP\&...] \fItopLayerNameOrID\fP

.SH DESCRIPTION
.PP
Creates an image, referring to the specified layer as the one which should be
used as the basis for containers which will be based on the image.

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

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

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

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

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

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

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

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

.SH EXAMPLE
.PP
\fBcontainers-storage create-image -f manifest.json -n new-image somelayer\fP

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