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

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


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


.SH DESCRIPTION
.PP
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
.PP
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
.PP
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).

.PP
.RS

.nf
% umoci init --layout image
% umoci new --image image:tag

.fi
.RE


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