.nh
.TH umoci-init(1) # umoci init - Create a new OCI image layout
Aleksa Sarai
DECEMBER 2016

.SH NAME
umoci init \- Create a new OCI image layout


.SH SYNOPSIS
\fBumoci init\fP
\fB--layout\fP=\fIimage\fP


.SH DESCRIPTION
Creates a new OCI image layout. The new OCI image does not contain any new
references or blobs, but those can be created through the use of
\fBumoci-new\fP(1), \fBumoci-tag\fP(1), \fBumoci-repack\fP(1) and other similar
commands.


.SH OPTIONS
The global options are defined in \fBumoci\fP(1).

.PP
\fB--layout\fP=\fIimage\fP
  The path where the OCI image layout will be created. The path must not exist
  already or \fBumoci-init\fP(1) will return an error.


.SH EXAMPLE
The following creates a brand new OCI image layout and then creates a blank tag
for further manipulation with \fBumoci-repack\fP(1) and \fBumoci-config\fP(1).

.EX
% umoci init --layout image
% umoci new --image image:tag
.EE


.SH SEE ALSO
\fBumoci\fP(1), \fBumoci-new\fP(1)