.TH "umoci-init" "1" " # umoci init - Create a new OCI image layout" "Aleksa Sarai" "DECEMBER 2016" 
.nh
.ad l


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