πŸ“šBook Signing at KubeCon EU 2026Meet us at Booking.com HQ (Mon 18:30-21:00) & vCluster booth #521 (Tue 24 Mar, 12:30-1:30pm) β€” free book giveaway!RSVP Booking.com Event
Deployments beginner ⏱ 10 minutes K8s Any

Retag and Push an Image in Local Quay

Pull an existing container image from Local Quay, retag it for a new repository path or version, and push the updated tag back to the registry.

By Luca Berton β€’ β€’ Updated February 16, 2026 β€’ πŸ“– 5 min read

πŸ’‘ Quick Answer: Pull the source image from Local Quay, retag to the new repository path, then push the new tag. Use --tls-verify=false only when your internal cert trust is not configured yet.

Use this workflow to duplicate or promote images between repositories in the same Local Quay instance.

1) Pull the Source Image

podman pull quay.internal.example.com/org-a/source-image:latest

For internal/self-signed cert environments:

podman pull --tls-verify=false quay.internal.example.com/org-a/source-image:latest

2) Retag to the Target Repository

podman tag \
  quay.internal.example.com/org-a/source-image:latest \
  quay.internal.example.com/org-b/target-image:2.26.6-rhel9.6

3) Push the New Tag

podman push quay.internal.example.com/org-b/target-image:2.26.6-rhel9.6

If trust is not configured yet:

podman push --tls-verify=false \
  quay.internal.example.com/org-b/target-image:2.26.6-rhel9.6

One-Shot Sequence

podman pull quay.internal.example.com/org-a/source-image:latest
podman tag quay.internal.example.com/org-a/source-image:latest quay.internal.example.com/org-b/target-image:2.26.6-rhel9.6
podman push quay.internal.example.com/org-b/target-image:2.26.6-rhel9.6

Operational Tips

  • Keep immutable version tags (for example, 2.26.6-rhel9.6) for traceability.
  • Avoid overwriting latest in production promotion flows.
  • Validate repository retention and access policies before publishing.
#quay #podman #retag #container-image #registry
Luca Berton
Written by Luca Berton

Principal Solutions Architect specializing in Kubernetes, AI/GPU infrastructure, and cloud-native platforms. Author of Kubernetes Recipes and creator of CopyPasteLearn courses.

Kubernetes Recipes book cover

Want More Kubernetes Recipes?

This recipe is from Kubernetes Recipes, our 750-page practical guide with hundreds of production-ready patterns.

Luca Berton Ansible Pilot Ansible by Example Open Empower K8s Recipes Terraform Pilot CopyPasteLearn ProteinLens