NAME

       umoci remove - Removes tags from OCI images

SYNOPSIS

       umoci remove --image=image[:tag]

       umoci rm --image=image[:tag]

DESCRIPTION

       Removes the given tag from the OCI image. The relevant blobs are not removed -- in order
       to remove all unused blobs see umoci-gc(1).

OPTIONS

       --image=image[:tag]
         The source OCI image tag to remove. image must be a path to a valid OCI
         image and tag must be a valid tag name (umoci-remove(1) does not return
         an error if the tag did not exist). If tag is not provided it defaults to
         "latest".

EXAMPLE

       The following creates a copy of a tag and then deletes the original.

              % umoci tag --image image:tag new-tag
              % umoci rm --image image:tag

SEE ALSO

       umoci(1), umoci-tag(1), umoci-gc(1)