Push a Podman-Saved Image to Local Quay

💡 Quick Answer: Run podman load -i image.tar, tag the loaded image to your Quay path (quay.internal.example.com/org/project/image:tag), authenticate with podman login, then push with podman push.

This guide shows how to take an image archive created with podman save and publish it to a Local Quay registry.

1) Load the Saved Image Archive

podman load -i image.tar

Typical output:

Loaded image(s): localhost/myimage:tag

Keep this source image name for the next step.

2) Tag the Image for Local Quay

Use the full registry + repository path exactly as it exists in Quay.

podman tag localhost/myimage:tag \
  quay.internal.example.com/org/project/myimage:latest

3) Authenticate to Local Quay

podman login quay.internal.example.com

For internal/self-signed environments (temporary troubleshooting only):

podman login --tls-verify=false quay.internal.example.com

4) Push the Image

podman push quay.internal.example.com/org/project/myimage:latest

If TLS trust is not configured yet:

podman push --tls-verify=false quay.internal.example.com/org/project/myimage:latest

Optional: Insecure Registry Configuration

If your internal registry is HTTP-only (not recommended for production), configure Podman registries first:

[[registry]]
location = "quay.internal.example.com"
insecure = true

Then push again with normal podman push.

Full Command Sequence

podman load -i image.tar
podman tag localhost/myimage:tag quay.internal.example.com/org/project/myimage:latest
podman login quay.internal.example.com
podman push quay.internal.example.com/org/project/myimage:latest

Common Errors

• requested access to the resource is denied: verify repository permissions in Quay.
• x509: certificate signed by unknown authority: add CA trust or use temporary --tls-verify=false.
• manifest unknown: check image/tag spelling.

Related Recipes

• Retag and Push an Image in Local Quay