.TH "umoci-remove" "1" " # umoci tag - Remove tags from OCI images" "Aleksa Sarai" "DECEMBER 2016" 
.nh
.ad l


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