podman-untag(1)

📦
version 6.1.4 · 5 versions
, in arch rolling, fedora 43, fedora 44, ubuntu resolute

💅 podman-untag — the manual page, but make it slay

okay bestie, welcome to podman-untag(1) ✨ it lives in the General Commands Manual section of your friendly neighbourhood podman docs, and it's about to become your new fav little cleanup tool 🧹💖

🌸 NAME 🌸

podman-untag — remove one or more names from a locally-stored image 🫶

basically: the reverse of tagging. the "un-💅" if you will.

✨ SYNOPSIS ✨

podman untag image [name[:tag]...]

podman image untag image [name[:tag]...]

two whole ways to say the same thing, because podman loves you and wants you to have options 💜

🦋 DESCRIPTION 🦋

so here's the vibe: this command removes one or more names from an image in the local storage 🎀

you can point at the image by ID or by reference — dealer's choice, both work, no cap.

  • if you specify no name at all, then all the names get removed from the image. all of them. every last one. it's giving spring cleaning 🧹✨
  • if the name you give is a short name and it doesn't include a registry, then localhost/ gets prefixed onto it. like, fedora becomes localhost/fedora 🏠
  • and if the name you give doesn't include a tag, then :latest gets appended. so localhost/fedora becomes localhost/fedora:latest 🏷️

little auto-complete gremlins doing their thing behind the scenes, iykyk 😌

💅 OPTIONS 💅

  • --help, -h — print the usage statement. your girl when you're lost: just asks for help 🥺

🌈 EXAMPLES 🌈

remove all tags from the specified image — full reset, main character energy 🔥

$ podman untag 0e3bbc2

remove a tag from a specified image — bye bye, :latest 👋

$ podman untag imageName:latest otherImageName:latest

remove multiple tags from the specified image — she's doing the most and honestly? ate 💀💖

$ podman untag httpd myhttpd myregistryhost:5000/fedora/httpd:v2

👑 SEE ALSO 👑

  • podman(1) — the mothership. go say hi 🛸

📜 HISTORY 📜

December 2019, originally compiled by Sascha Grunert sgrunert@suse.com ⟨mailto:sgrunert@suse.com⟩ — a real one fr fr 🫡

and that's the whole page bestie, no crumbs left 🍓💜 this was podman-untag(1) from the General Commands Manual, and the version/date living down at the bottom of the original is, as always, just podman-untag(1) — so consider this your cute lil' sign-off ✨ go untag something and feel iconic 💅🎀🌈

📦 where this page comes from