Terms & conditionsThe Red Hat Universal Base Image is free to deploy on Red Hat or non-Red Hat platforms and freely redistributable. Software vendors and community projects which build on UBI may have additional EULAs which apply to their layered software. Please refer to the End User License Agreement for the Red Hat Universal Base Image for information about use of the Red Hat Universal Base Image and associated software and source code.Registry tokens
Use a registry service account token to authenticate your container client. This allows you to pull images without using your personal Red Hat credentials, which is recommended for CI/CD pipelines and automated deployments.
Using Podman login
Run the following command, then enter your registry token credentials when prompted by the terminal.
Pull the image
Image identifiers
Red Hat login
Use the following instructions to get images from a Red Hat container registry using your Red Hat login.
Using Podman login
Run the following command, then enter your login credentials when prompted by the terminal.
Pull the image
Image identifiers
Unauthenticated
Use the following instructions to get images from a Red Hat container registry without providing authentication.
Update to new container registryTo support our existing users and users to come, we will be transitioning our product portfolio and customers to a new container registry. The new registry uses standard OAuth mechanisms to provide customers with the ability to configure their systems to pull containerized content using static tokens or their Red Hat login. Customers are encouraged to begin using the new registry as their preferred authentication method.Using podman
Use the following command(s) from a system with podman installed.
Image identifiers
Getting source containers
Source code is available for all Red Hat UBI-based images in the form of downloadable containers. Here are a few things you should know about Red Hat source containers.
- Although they are packaged as containers, source containers cannot be run. So instead of using podman pull to get them to your system, use the skopeo command.
- Source containers are named based on the binary containers they represent. So, for example, to get the source container for a particular standard RHEL UBI 8 container (registry.access.redhat.com/ubi8/ubi8.1-397) you simply append -source to get the source code container for that image (registry.access.redhat.com/ubi8/ubi8.1-397-source).
- Once a source container is copied to a local directory, you can use a combination of tar,gzip, and rpm commands to work with that content.
Step one
Use skopeo to copy the source image to a local directory
Step two
Inspect the image
Step three
Untar the contents
Step four
Begin examining and using the content.
