umoci-remove(1)(#)

💅 umoci-remove — the "okay bye bestie" of OCI tags

so this is a page from the umoci manual (section 1, the commands-and-user-tools girlies ✨), written by Aleksa Sarai back in DECEMBER 2016. yes it's old, no it's not expired, it's vintage. 💖

---

🌸 NAME 🌸

umoci remove — Removes tags from OCI images. it's giving "block and delete" but for tags. 🎀

---

✨ SYNOPSIS ✨

umoci remove --image=image[:tag]

umoci rm --image=image[:tag]

two whole ways to say the same thing, because remove is long and rm is the lowercase little sister. both slay. 🫶

---

🦋 DESCRIPTION 🦋

okay so here's the tea: this command Removes the given tag from the OCI image. that's it. that's the whole job. ✨

but — and this is the part everyone misses — the relevant blobs are not removed. like, the tag goes away but the actual data is still chilling in there. ngl if you thought deleting the tag frees up space you were lowkey wrong 🙈. in order to remove all unused blobs see umoci-gc(1) — that's the one that actually does the cleanup, and she's a whole separate command. 💅

---

🎀 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. and here's the plot twist bestie: umoci-remove(1) does not return an error if the tag did not exist. so if you're deleting something that isn't there, she'll just shrug and move on, no drama, no error message. 😌 If tag is not provided it defaults to "latest" — so yes, no tag means you're deleting latest, main character behaviour. 👑

---

💖 EXAMPLE 💖

The following creates a copy of a tag and then deletes the original. it's giving "make a backup bestie then yeet the og" 🧚

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

step one: copy image:tag into new-tag so you don't lose her. step two: umoci rm --image image:tag and she's gone, but the blobs are still in there, remember? go see umoci-gc(1) if that's bugging you. 🔥

---

🌈 SEE ALSO 🌈

• umoci(1)
• umoci-tag(1)
• umoci-gc(1)

---

💀 quick vibe check: this removes the tag, not the blobs. do not come for me later saying your disk is full, i warned you, i literally warned you, it's in the DESCRIPTION and everything. go run umoci-gc(1). 🫶

---

okay that's the whole page bestie — this was umoci-remove(1) from the umoci manual, source tag tag / umoci, dated DECEMBER 2016, authored by Aleksa Sarai. mwah, go delete responsibly. 💅✨🎀