Chapter 5. Configuring model catalog sources in OpenShift


As an OpenShift cluster administrator, you can configure a custom model catalog source by adding an entry to the model-catalog-sources config map in OpenShift. This entry provides details such as the catalog name and the location of the catalog source file that specifies your model definitions.

Prerequisites

  • You are logged in to the OpenShift web console with cluster administrator privileges.
  • You have created a catalog source file that specifies your model definitions. For an example catalog source file, see the sample-catalog.yaml file from Kubeflow Model Registry.

Procedure

  1. In the OpenShift web console navigation menu, click Workloads ConfigMaps.
  2. In the Project list, enter rhoai-model-registries, and click the project name.
  3. Click the model-catalog-sources config map name.
  4. Click the YAML tab to view the contents of the config map .yaml file.
  5. Find the data: sources.yaml section to add your custom catalog source.
  6. Add a new entry under the catalogs field, for example:

    data:
      sources.yaml: |-
        catalogs:
         - name: Sample Catalog
           id: sample_custom_catalog
           type: yaml
           enabled: true
           properties:
            yamlCatalogPath: sample-catalog.yaml
           labels:
           - Sample Catalog
      sample-catalog.yaml: |-
         <contents of your catalog file>
    Copy to Clipboard Toggle word wrap

    This example adds the sample-catalog.yaml file in the same config map as a sibling of sources.yaml and references the sample catalog file in the yamlCatalogPath property.

    The sample catalog source entry is described as follows:

    • name: The user-friendly name of the catalog source.
    • id: The unique ID of the catalog source.
    • type: The catalog source type. Use yaml.
    • enabled: Whether the catalog source is enabled. Defaults to true.
    • properties.yamlCatalogPath: The location of your catalog source file.
    • labels: Optional labels for your catalog source to display in the catalog.
  7. Click Save.

Verification

  1. In the OpenShift AI dashboard, click AI hub Catalog.
  2. In the menu bar, to view models from your new catalog source:

    • If your catalog source has no label, click Other models.
    • If your catalog source has a label, click <your-label-name> models.

      Note

      These changes might take a few minutes to be displayed in the catalog on the dashboard.

Red Hat logoGithubredditYoutubeTwitter

Learn

Try, buy, & sell

Communities

About Red Hat Documentation

We help Red Hat users innovate and achieve their goals with our products and services with content they can trust. Explore our recent updates.

Making open source more inclusive

Red Hat is committed to replacing problematic language in our code, documentation, and web properties. For more details, see the Red Hat Blog.

About Red Hat

We deliver hardened solutions that make it easier for enterprises to work across platforms and environments, from the core datacenter to the network edge.

Theme

© 2026 Red Hat
Back to top