Chapter 3. Understanding the OperatorHub

download PDF

This guide outlines the architecture of the OperatorHub.

3.1. Overview of the OperatorHub

The OperatorHub is available via the OpenShift Container Platform web console and is the interface that cluster administrators use to discover and install Operators. With one click, an Operator can be pulled from their off-cluster source, installed and subscribed on the cluster, and made ready for engineering teams to self-service manage the product across deployment environments using the Operator Lifecycle Manager (OLM).

Cluster administrators can choose from OperatorSources grouped into the following categories:


Red Hat Operators

Red Hat products packaged and shipped by Red Hat. Supported by Red Hat.

Certified Operators

Products from leading independent software vendors (ISVs). Red Hat partners with ISVs to package and ship. Supported by the ISV.

Community Operators

Optionally-visible software maintained by relevant representatives in the operator-framework/community-operators GitHub repository. No official support.

Custom Operators

Operators you add to the cluster yourself. If you have not added any Custom Operators, the Custom category does not appear in the web console on your OperatorHub.


OperatorHub content automatically refreshes every 60 minutes.

3.2. OperatorHub architecture

The OperatorHub UI component is driven by the Marketplace Operator by default on OpenShift Container Platform in the openshift-marketplace namespace.

The Marketplace Operator manages OperatorHub and OperatorSource Custom Resource Definitions (CRDs).


Although some OperatorSource information is exposed through the OperatorHub user interface, it is only used directly by those who are creating their own Operators.


While OperatorHub no longer uses CatalogSourceConfig resources, they are still supported in OpenShift Container Platform.

3.2.1. OperatorHub CRD

You can use the OperatorHub CRD to change the state of the default OperatorSources provided with OperatorHub on the cluster between enabled and disabled. This capability is useful when configuring OpenShift Container Platform in restricted network environments.

Example OperatorHub Custom Resource

kind: OperatorHub
  name: cluster
  disableAllDefaultSources: true 1
  sources: [ 2
      name: "community-operators",
      disabled: false

disableAllDefaultSources is an override that controls availability of all default OperatorSources that are configured by default during a OpenShift Container Platform installation.
Disable default OperatorSources individually by changing the disabled parameter value per source.

3.2.2. OperatorSource CRD

For each Operator, the OperatorSource CRD is used to define the external data store used to store Operator bundles.

Example OperatorSource Custom Resource

kind: OperatorSource
  name: community-operators
  namespace: marketplace
  type: appregistry 1
  endpoint: 2
  registryNamespace: community-operators 3
  displayName: "Community Operators" 4
  publisher: "Red Hat" 5

To identify the data store as an application registry, type is set to appregistry.
Currently, Quay is the external data store used by the OperatorHub, so the endpoint is set to for the appregistry.
For a Community Operator, registryNamespace is set to community-operator.
Optionally, set displayName to a name that appears for the Operator in the OperatorHub UI.
Optionally, set publisher to the person or organization publishing the Operator that appears in the OperatorHub UI.
Red Hat logoGithubRedditYoutubeTwitter


Try, buy, & sell


About Red Hat Documentation

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

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.

© 2024 Red Hat, Inc.