Push an image

To upload a container image to the Katapult Container Registry (KCR), use a container management tool such as Docker or Buildah.

Docker is a popular tool for building, sharing, and running container images. It offers a straightforward, user-friendly interface for managing containers.

Buildah is a flexible, daemonless tool for building OCI-compliant images. Ideal for advanced workflows and environments where Docker isn’t available or preferred.

Choose the appropriate tool below based on your environment and requirements:

Docker

docker push kcr.io/<org>/<image>:<tag>

Buildah

If your image is in the docker format

buildah push docker://kcr.io/<org>/<image>:<tag>

If your image is in the OCI format

buildah push oci://kcr.io/<org>/<image>:<tag>

Podman

podman push kcr.io/<org>/<image>:<tag>