podman-tag(1)

📦
version 6.1.4 · 3 versions
, in alpine 3.24, arch rolling, centos-stream 10, centos-stream 9, fedora 43, fedora 44, nixos 26.05, nixpkgs unstable, opensuse-leap 16.0, ubuntu resolute, ubuntu stonking

💖 podman-tag(1) — the general commands manual, but make it cute

okay bestie, gather round, because this is the podman-tag page from the General Commands Manual and it's literally the glow-up your local images have been waiting for ✨

✨ NAME ✨

podman-tag — add an additional name to a local image 🏷️

🦋 SYNOPSIS 🦋

podman tag image[:tag] [target-name[:tag]...] [options]

podman image tag image[:tag] [target-name[:tag]...] [options]

🌸 DESCRIPTION 🌸

So what this does is it assigns a new image name to an existing image. That's it, that's the whole vibe. 💅

A full name means the entire image name, and yes that includes the optional tag that lives after the :. Like, the whole package, not just the first part.

And if you don't hand over a tag? Podman just defaults to latest — for both the image and the target-name. No tag, no stress, it's giving :latest energy by default. 🎀

👑 OPTIONS 👑

  • --help, -h — print usage statement. That's the whole option list bestie, she's low maintenance fr fr 🙈

🍓 EXAMPLES 🍓

Tag specified image with an image name defaulting to :latest.

$ podman tag 0e3bbc2 fedora:latest

Tag specified image with fully specified image name.

$ podman tag httpd myregistryhost:5000/fedora/httpd:v2

Tag specified image with multiple tags.

$ podman tag mymariadb mycontainerregistry.io/namespace/mariadb:10 mycontainerregistry.io/namespace/mariadb:10.11 mycontainerregistry.io/namespace/mariadb:10.11.12

like, one image, three tags, absolutely iconic behavior 🌈⭐

🌟 SEE ALSO 🌟

podman(1) — go read the main character's page too 🫶

💜 HISTORY 💜

  • December 2019 — Update description to refer to 'name' instead of 'alias' by Sascha Grunert sgrunert@suse.com ⟨mailto:sgrunert@suse.com⟩
  • July 2017 — Originally compiled by Ryan Cole rycole@redhat.com ⟨mailto:rycole@redhat.com⟩

and that's the whole page, no cap 💖 This was podman-tag(1) from the General Commands Manual, last touched by those lovely humans back in December 2019 (and born way back in July 2017) — so yeah, it's a classic, and it ate. 🎀✨💅

📦 where this page comes from