Universal Base Images (UBI): Images, repositories, packages, and source code
Using Red Hat Universal Base Images (UBI) offers a way to build your container images on a foundation of Red Hat Enterprise Linux software. See Characteristics of UBI images for details on using Red Hat UBI container images.
This article identifies:
- Images: Information on how to find available Red Hat UBI container images
- Repositories: Available software repositories for updating and adding to UBI container images with RPM packages that can be freely redistributed
- RPM packages: Descriptions of how to find all the packages in and available to UBI container images
- Source code images: Descriptions of how to get source container images for each published UBI container image
If you have problems or enhancement requests for UBI, enter a bug at https://issues.redhat.com under the RHEL project. For package requests, please set the Component to distribution and prepend "UBI" to the Summary. Problems or suspected bugs should have the Component set to the specific UBI container images that is affected. For example, set ubi9-container for issues involving UBI9. Red Hat customers can enter a Red Hat Support Case.
NOTE: Although we make a best effort to keep this article up to date, the only true way to obtain the latest list of Red Hat UBI images, repositories, and RPM packages is to check the source of that information directly. Each section below describes how to obtain that information.
Red Hat UBI Images
For the latest list of images and details about each image, refer to the Red Hat Universal Base Image section of the Red Hat Ecosystem Catalog. Red Hat UBI images are available from both authenticated (registry.redhat.io) and unauthenticated (registry.access.redhat.com) registries.
Red Hat UBI repositories
Each Red Hat UBI image is pre-configured to point to UBI yum repositories that contain the latest versions of UBI RPM packages.
The UBI repositories contain a small subset of the RPM packages of Red Hat Enterprise Linux repositories, but no subscription is needed to update images from packages in the UBI repositories.
The /etc/yum.repos.d/ubi.repo file inside each UBI container contains entries for available UBI repositories.
Those set to enabled = 1 are currently enabled. Refer to the baseurl for each repository to see the location of those packages. Type yum repolist to see the list of enabled repositories (yum is not available in the minimal and micro UBI images).
The following Red Hat UBI repositories are enabled by default within RHEL 7, RHEL 8, and RHEL 9 UBI images.
NOTE: The -rpms suffix was added to all UBI repository names (e.g. ubi-8-appstream-rpms) and also the --debug-rpms suffix was added to all debug repository names (e.g. ubi-8-appstream-debug-rpms) to match the format that DNF or YUM expected.
RHEL 7 UBI repositories
| repository id | repository name |
|---|---|
| ubi-7 | Red Hat Universal Base Image 7 Server (RPMs) |
| ubi-7-rhah | Red Hat Universal Base Image Atomic Host (RPMs) |
| ubi-7-server-devtools-rpms | Red Hat Developer Tools RPMs for Red Hat Universal Base Image 7 Server |
| ubi-7-server-extras-rpms | Red Hat Universal Base Image 7 Server - Extras (RPMs) |
| ubi-7-server-optional-rpms | Red Hat Universal Base Image 7 Server - Optional (RPMs) |
| ubi-server-rhscl-7-rpms | Red Hat Software Collections RPMs for Red Hat Universal Base Image 7 Server |
RHEL 8 UBI repositories
| repository id | repository name |
|---|---|
| ubi-8-appstream-rpms | Red Hat Universal Base Image 8 (RPMs) - AppStream |
| ubi-8-baseos-rpms | Red Hat Universal Base Image 8 (RPMs) - BaseOS |
RHEL 9 UBI repositories
| repository id | repository name |
|---|---|
| ubi-9-appstream-rpms | Red Hat Universal Base Image 9 (RPMs) - AppStream |
| ubi-9-baseos-rpms | Red Hat Universal Base Image 9 (RPMs) - BaseOS |
Red Hat UBI RPM packages
To see a list of RPM packages installed inside a Red Hat UBI container, type: rpm -qa
To see all available RPM packages from inside a Red Hat UBI container, type: yum list all
Note that the yum command is not available in the minimal and micro images.
Another way to find the RPM packages available to all UBI images is to browse the UBI repositories. As noted earlier, all UBI repositories are listed in the /etc/yum.repos.d/ubi.repo file within each UBI container.
The URL to each repository is listed with the repository name. Replace $basearch with your computer architecture, such as x86_64, as shown in the examples:
- ubi7: https://cdn-ubi.redhat.com/content/public/ubi/dist/ubi/server/7/7Server/x86_64/os
- ubi-7-rhah: https://cdn-ubi.redhat.com/content/public/ubi/dist/ubi/atomic/7/7Server/x86_64/os
- ubi-7-server-extras-rpms: https://cdn-ubi.redhat.com/content/public/ubi/dist/ubi/server/7/7Server/x86_64/extras/os
- ubi-7-server-optional-rpms: https://cdn-ubi.redhat.com/content/public/ubi/dist/ubi/server/7/7Server/x86_64/optional/os
- ubi-server-rhscl-7-rpms: https://cdn-ubi.redhat.com/content/public/ubi/dist/ubi/server/7/7Server/x86_64/rhscl/1/os
- ubi-8-baseos-rpms: https://cdn-ubi.redhat.com/content/public/ubi/dist/ubi8/8/x86_64/baseos/os
- ubi-8-appstream-rpms: https://cdn-ubi.redhat.com/content/public/ubi/dist/ubi8/8/x86_64/appstream/os
- ubi-8-codeready-builder-rpms: https://cdn-ubi.redhat.com/content/public/ubi/dist/ubi8/8/x86_64/codeready-builder/os/
- ubi-9-baseos-rpms: https://cdn-ubi.redhat.com/content/public/ubi/dist/ubi9/9/x86_64/baseos/os
- ubi-9-appstream-rpms: https://cdn-ubi.redhat.com/content/public/ubi/dist/ubi9/9/x86_64/appstream/os
- ubi-9-codeready-builder-rpms: https://cdn-ubi.redhat.com/content/public/ubi/dist/ubi9/9/x86_64/codeready-builder/os/
Red Hat UBI source container images
Red Hat now produces source container images, containing all source code associated with each Universal Base Image (UBI) that it publishes. To read about UBI source container images and how to obtain them, refer to Getting UBI Container Image Source Code.
Comments