Red Hat Summit Red Hat SummitApoyoConsolaDesarrolladoresIniciar una pruebaContacto

Este contenido no está disponible en el idioma seleccionado.

Configure access to your container images

Red Hat build of Podman Desktop 0.9

Explore how you can configure access to your registries to work with your container images.

Red Hat Customer Content Services

Abstract

Set up pre-configured and custom container registries in Red Hat build of Podman Desktop.

Preface
Copiar enlace

You can configure access to container registries to pull and push container images. Red Hat build of Podman Desktop supports both pre-configured and custom registries. Pre-configured registries include Docker Hub, Red Hat Quay, GitHub Container Registry, Google Container Registry, and Red Hat ecosystem catalog (registry.redhat.io). You can add custom registries manually. Follow the procedures in this documentation for setting up authentication with both types of registries.

Chapter 1. Set up a pre-configured registry
Copiar enlace

Red Hat build of Podman Desktop provides pre-configured registries to simplify authentication for the most popular container registries. You can quickly set up authentication for these registries without manually configuring registry locations.

Red Hat build of Podman Desktop includes pre-configured registries for:

  • Docker Hub
  • Red Hat Quay
  • GitHub Container Registry
  • Google Container Registry
  • Red Hat ecosystem catalog (registry.redhat.io)

If your container registry is in this list, you can authenticate by providing your credentials through the UI. Red Hat build of Podman Desktop automatically handles the registry configuration and authentication process.

Note

As an administrator, you can edit the managed defaults and locked configuration files to lock the values for the registries.defaults option. This helps in configuring default registries and their mirrors for your enterprise needs. For more details, refer to Deploy a managed user environment.

Prerequisites

Ensure that you have:

  • Authentication details for your container registry:

    • User name
    • Password or OAuth secret
  • The fully qualified name of a private image stored in your registry, such as my-registry.tld/my-repository/my-image.
  • The fully qualified image name that your registry requires to push an image, such as my-registry.tld/my-repository/my-image.

Procedure

  1. Go to the Settings > Registries page from the left navigation pane.

  2. Click Configure corresponding to the registry you want to set up.

    authenticating to a preconfigured registry

  3. Enter your registry credentials:

    1. Username: Enter your user name.
    2. Password: Enter your password or OAuth secret.
    3. Click Login.

Verification

Red Hat build of Podman Desktop authenticates Podman with the registry using the credentials you provided. You can now pull and push images to and from the pre-configured registry.

Chapter 2. Set up a custom registry
Copiar enlace

You can configure authentication for any container registry, including custom registries that are not available in the pre-configured list. In the Red Hat build of Podman Desktop UI, you can add and authenticate with any registry by providing the registry location and your credentials.

Note

As an administrator, you can edit the managed defaults and locked configuration files to lock the values for the registries.defaults option. This helps in configuring default registries and their mirrors for your enterprise needs. For more details, refer to Deploy a managed user environment.

Prerequisites

Ensure that you have:

  • Authentication details for your container registry:

    • Registry URL (for example, https://myregistry.tld)
    • User name
    • Password or OAuth secret
  • The fully qualified name of a private image stored in your registry, such as my-registry.tld/my-repository/my-image.
  • The fully qualified image name that your registry requires to push an image, such as my-registry.tld/my-repository/my-image.

Procedure

  1. Go to the Settings > Registries page from the left navigation pane.
  2. Click Add registry at the top right corner of the screen. A pop-up opens.

  3. Enter your registry details:

    add registry pop up
    1. URL (HTTPS only): Enter your repository URL, such as https://myregistry.tld.
    2. Username: Enter your user name.
    3. Password: Enter your password or OAuth secret.
    4. Click Add.

Verification

  • Red Hat build of Podman Desktop authenticates Podman with your custom registry using the credentials you provided. You can now pull and push images to and from the custom registry.

Legal Notice
Copiar enlace

Copyright © Red Hat.
The text of and illustrations in this document are licensed by Red Hat under a Creative Commons Attribution–Share Alike 3.0 Unported license ("CC-BY-SA"). An explanation of CC-BY-SA is available at http://creativecommons.org/licenses/by-sa/3.0/. In accordance with CC-BY-SA, if you distribute this document or an adaptation of it, you must provide the URL for the original version.
Red Hat, as the licensor of this document, waives the right to enforce, and agrees not to assert, Section 4d of CC-BY-SA to the fullest extent permitted by applicable law.
Red Hat, Red Hat Enterprise Linux, the Shadowman logo, JBoss, OpenShift, Fedora, the Infinity logo, and RHCE are trademarks of Red Hat, Inc., registered in the United States and other countries.
Linux® is the registered trademark of Linus Torvalds in the United States and other countries.
Java® is a registered trademark of Oracle and/or its affiliates.
XFS® is a trademark of Silicon Graphics International Corp. or its subsidiaries in the United States and/or other countries.
MySQL® is a registered trademark of MySQL AB in the United States, the European Union and other countries.
Node.js® is an official trademark of Joyent. Red Hat Software Collections is not formally related to or endorsed by the official Joyent Node.js open source or commercial project.
The OpenStack® Word Mark and OpenStack logo are either registered trademarks/service marks or trademarks/service marks of the OpenStack Foundation, in the United States and other countries and are used with the OpenStack Foundation's permission. We are not affiliated with, endorsed or sponsored by the OpenStack Foundation, or the OpenStack community.
All other trademarks are the property of their respective owners.
Red Hat logoGithubredditYoutubeTwitter

Aprender

Pruebe, compre y venda

Comunidades

Acerca de la documentación de Red Hat

Ayudamos a los usuarios de Red Hat a innovar y alcanzar sus objetivos con nuestros productos y servicios con contenido en el que pueden confiar. Explore nuestras recientes actualizaciones.

Hacer que el código abierto sea más inclusivo

Red Hat se compromete a reemplazar el lenguaje problemático en nuestro código, documentación y propiedades web. Para más detalles, consulte el Blog de Red Hat.

Acerca de Red Hat

Ofrecemos soluciones reforzadas que facilitan a las empresas trabajar en plataformas y entornos, desde el centro de datos central hasta el perímetro de la red.

Theme

© 2026 Red HatVolver arriba