NAME

       umoci new - Create a blank tag in an OCI image

SYNOPSIS

       umoci new --image=image[:tag]

DESCRIPTION

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

       Once a new image is created  with  umoci-new(1)  you  can  directly  use  the  image  with
       umoci-unpack(1),  umoci-repack(1),  and  umoci-config(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.

OPTIONS

       The global options are defined in umoci(1).

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

EXAMPLE

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

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

SEE ALSO

       umoci(1), umoci-unpack(1), umoci-repack(1), umoci-config(1)