Universal Base Images (UBI): Images, repositories, and packages

Updated -

Using Red Hat Universal Base Images (UBI) offers a way to build your images on a foundation of Red Hat Enterprise Linux software. See Using Red Hat Universal Base Images for details on using Red Hat UBI images.

This article identifies:

  • Images: The names and locations of Red Hat UBI images
  • Repositories: Available software repositories for updating and adding to UBI images with RPM packages that can be freely redistributed
  • RPM packages: Descriptions of how to find all the packages in and available to UBI images

If you have problems or enhancement requests for UBI, enter a bug at the Red Hat Bugzilla site (under the distribution BZ component and UBI7 or UBI8). See the UBI Weekly bug list for the current set of bugs. 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

Here is a list of current 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 Container Catalog.

Registry names Namespace Image RHEL version
registry.access.redhat.com registry.redhat.io / ubi8 8.1
ubi8-minimal 8.1
ubi8-init 8.1
registry.access.redhat.com registry.redhat.io ubi8/ ubi 8.1
ubi-init 8.1
ubi-minimal 8.1
s2i-core 8.1
s2i-base 8.1
dotnet-21-runtime 8.1
dotnet-21 8.1
perl-526 8.1
php-72 8.1
nodejs-10 8.1
ruby-25 8.1
python-27 8.1
python-36 8.1
go-toolset 8.1
ruby-26 8.1
nodejs-12 8.1
php-73 8.1
dotnet-30-runtime 8.1
dotnet-30 8.1
registry.access.redhat.com registry.redhat.io / ubi7 7.7
ubi7 7.7
ubi7-minimal 7.7
ubi7-init 7.7
registry.access.redhat.com registry.redhat.io ubi7/ ubi 7.7
ubi 7.7
ubi-init 7.7
ubi-minimal 7.7
php-72 7.7
php-73 7.7
nodejs-8 7.7
nodejs-10 7.7
nodejs-12 7.7
ruby-25 7.7
ruby-26 7.7
python-27 7.7
python-36 7.7
s2i-core 7.7
s2i-base 7.7
go-toolset-rhel7 7.7

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.
No subscription is needed to update Red Hat UBI images from packages in those 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 UBI images).

The following Red Hat UBI repositories are enabled by default within RHEL 7 and RHEL 8 UBI images.

RHEL 7 UBI repositories

repo id repo name status
ubi-7/x86_64 Red Hat Universal Base Image 7 Server (RPMs) 832
ubi-7-rhah/x86_64 Red Hat Universal Base Image Atomic Host (RPMs) 3
ubi-7-server-extras-rpms/x86_64 Red Hat Universal Base Image 7 Server - Extras (RPMs) 3
ubi-7-server-optional-rpms/x86_64 Red Hat Universal Base Image 7 Server - Optional (RPMs) 18
ubi-server-rhscl-7-rpms/x86_64 Red Hat Software Collections RPMs for Red Hat Universal Base Image 7 Server 320

RHEL 8 UBI repositories

repo id repo name status
ubi-8-appstream Red Hat Universal Base Image 8 (RPMs) - AppStream 727
ubi-8-baseos Red Hat Universal Base Image 8 (RPMs) - BaseOS 644

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 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's architecture, such as x86_64, as shown in the examples:

3 Comments

The rhel8/ namespace seem out-of-scope for this article since they're not UBI images, despite being built on UBI.

The packages "rpm-build" or "subversion" cannot be installed in the UBI-8 images. Is there a way to install them?

# yum install -y subversion
Updating Subscription Management repositories.
Unable to read consumer identity
This system is not registered to Red Hat Subscription Management. You can use subscription-manager to register.
Red Hat Universal Base Image 8 (RPMs) - AppStream                                                                                                                                                             370 kB/s | 1.9 MB     00:05
Red Hat Universal Base Image 8 (RPMs) - BaseOS                                                                                                                                                                143 kB/s | 745 kB     00:05
Last metadata expiration check: 0:00:01 ago on Mon Sep  2 20:41:05 2019.
No match for argument: subversion
Error: Unable to find a match

How do I use a recent developer toolset with UBI 7? I.e. can I build code for UBI 7 with a newer gcc than 4.8.5?