.nh
.TH umoci-remove(1) # umoci tag - Remove tags from OCI images
Aleksa Sarai
DECEMBER 2016

.SH NAME
.PP
umoci remove - Removes tags from OCI images


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

.PP
\fBumoci rm\fP
\fB--image\fP=\fIimage\fP[:\fItag\fP]


.SH DESCRIPTION
.PP
Removes the given tag from the OCI image. The relevant blobs are \fBnot\fP
removed -- in order to remove all unused blobs see \fBumoci-gc\fP(1).


.SH OPTIONS
.PP
\fB--image\fP=\fIimage\fP[:\fItag\fP]
  The source OCI image tag to remove. \fIimage\fP must be a path to a valid OCI
  image and \fItag\fP must be a valid tag name (\fBumoci-remove\fP(1) does not return
  an error if the tag did not exist). If \fItag\fP is not provided it defaults to
  "latest".


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

.PP
.RS

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

.fi
.RE


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