.nh
.TH umoci-new(1) # umoci new - Create a blank tag in an OCI image
Aleksa Sarai
DECEMBER 2016

.SH NAME
.PP
umoci new - Create a blank tag in an OCI image


.SH SYNOPSIS
.PP
\fBumoci new\fP
\fB--image\fP=\fIimage\fP[:\fItag\fP]


.SH DESCRIPTION
.PP
Create a blank tag in an OCI image. The created image's configuration and
manifest are all set to \fBumoci\fP-defined default values, with no filesystem
layer blobs added to the image.

.PP
Once a new image is created with \fBumoci-new\fP(1) you can directly use the
image with \fBumoci-unpack\fP(1), \fBumoci-repack\fP(1), and \fBumoci-config\fP(1) to
modify the new tagged image as you see fit. This allows you to create entirely
new images from scratch, without needing a base image to start with.


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

.PP
\fB--image\fP=\fIimage\fP[:\fItag\fP]
  The destination of the blank tag in the OCI image. \fIimage\fP must be a path to
  a valid OCI image, and \fItag\fP must be a valid tag name. If a tag already
  exists with the name \fItag\fP it will be overwritten. If \fItag\fP is not provided
  it defaults to "latest".


.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-unpack\fP(1), \fBumoci-repack\fP(1), \fBumoci-config\fP(1)