{"id":49766,"date":"2025-06-21T17:22:16","date_gmt":"2025-06-21T17:22:16","guid":{"rendered":"https:\/\/www.devopsschool.com\/blog\/?p=49766"},"modified":"2026-02-21T07:29:34","modified_gmt":"2026-02-21T07:29:34","slug":"openshift-add-all-operatorhub-io-operators-to-openshift","status":"publish","type":"post","link":"https:\/\/www.devopsschool.com\/blog\/openshift-add-all-operatorhub-io-operators-to-openshift\/","title":{"rendered":"Openshift: Add All OperatorHub.io Operators to OpenShift"},"content":{"rendered":"\n
\"\"<\/figure>\n\n\n\n

Here’s a complete, step-by-step tutorial \u2014 with explanations<\/strong> \u2014 to add OperatorHub.io operators<\/strong> to OpenShift<\/strong> by creating a custom CatalogSource<\/code><\/strong> pointing to their community catalog image from Quay.io<\/a>.<\/p>\n\n\n\n

\n\n\n\n
\n\n\n\n

\ud83c\udfaf Goal<\/h2>\n\n\n\n

You will configure OpenShift to pull operators directly from the OperatorHub.io community catalog<\/strong>, so that all available community operators appear inside your OperatorHub UI<\/strong>.<\/p>\n\n\n\n

\n\n\n\n

\ud83e\uddf0 Prerequisites<\/h2>\n\n\n\n
    \n
  • \u2705 OpenShift 4.x cluster (4.8+ recommended)<\/li>\n\n\n\n
  • \u2705 oc<\/code> CLI installed and logged in as cluster-admin<\/code><\/li>\n\n\n\n
  • \u2705 Internet access to quay.io<\/code><\/li>\n<\/ul>\n\n\n\n
    \n\n\n\n

    \u2705 Step 1: Understand What We\u2019re Doing<\/h2>\n\n\n\n

    OpenShift uses the Operator Lifecycle Manager (OLM) to manage OperatorHub. Operator catalogs are delivered via objects called CatalogSource<\/code>, which point to an OCI-based operator index (usually a container image).<\/p>\n\n\n\n

    We’ll be adding a new CatalogSource<\/code> that points to:<\/p>\n\n\n

    quay.io\/operatorhubio\/catalog:latest\n<\/code><\/span><\/pre>\n\n\n
    This image is maintained by the OperatorHub.io<\/strong> team and contains all operators shown on their site.<\/p>\n\n\n\n
    \n\n\n\n
    \ud83d\udcc4 Step 2: Create the YAML File<\/h2>\n\n\n\n
    Save the following content into a file named: operatorhubio-catalogsource.yaml<\/code><\/p>\n\n\n
    apiVersion: operators.coreos.com\/v1alpha1\nkind<\/span>: CatalogSource\nmetadata<\/span>:\n  name: operatorhubio-catalog\n  namespace<\/span>: openshift-marketplace\nspec<\/span>:\n  sourceType: grpc\n  image<\/span>: quay.io\/operatorhubio\/catalog:latest\n  displayName<\/span>: \"OperatorHub.io Community Catalog\"<\/span>\n  publisher<\/span>: \"OperatorHub.io\"<\/span>\n  updateStrategy<\/span>:\n    registryPoll:\n      interval: 45<\/span>m\n<\/code><\/span>Code language:<\/span> JavaScript<\/span> (<\/span>javascript<\/span>)<\/span><\/small><\/pre>\n\n\n
    \ud83d\udcd8 What Each Field Means:<\/h3>\n\n\n\n
    Field<\/th>Description<\/th><\/tr><\/thead>
    name<\/code><\/td>Internal name used by OLM<\/td><\/tr>
    namespace<\/code><\/td>Must be openshift-marketplace<\/code> so it’s cluster-wide<\/td><\/tr>
    image<\/code><\/td>Points to the community operator index<\/td><\/tr>
    displayName<\/code><\/td>Friendly name shown in OpenShift UI<\/td><\/tr>
    publisher<\/code><\/td>Shown in the OperatorHub UI<\/td><\/tr>
    updateStrategy<\/code><\/td>Polls the registry every 45 min for updates<\/td><\/tr><\/tbody><\/table><\/figure>\n\n\n\n
    \n\n\n\n
    \ud83d\udce5 Step 3: Apply the YAML<\/h2>\n\n\n\n
    Run the following command to apply the custom catalog:<\/p>\n\n\n
    oc<\/span> apply<\/span> -f<\/span> operatorhubio-catalogsource<\/span>.yaml<\/span>\n<\/code><\/span>Code language:<\/span> CSS<\/span> (<\/span>css<\/span>)<\/span><\/small><\/pre>\n\n\n
    You should see:<\/p>\n\n\n
    catalogsource.operators.coreos.com\/operatorhubio-catalog created\n<\/code><\/span><\/pre>\n\n\n
    \n\n\n\n
    \ud83d\udc40 Step 4: Verify the CatalogSource Is Working<\/h2>\n\n\n\n
    Check the status of the catalog:<\/p>\n\n\n
    oc get<\/span> catalogsource -n openshift-marketplace\n<\/code><\/span>Code language:<\/span> JavaScript<\/span> (<\/span>javascript<\/span>)<\/span><\/small><\/pre>\n\n\n
    Expected output:<\/p>\n\n\n
    NAME<\/span>                    DISPLAY<\/span>                          PUBLISHER<\/span>         AGE<\/span>\noperatorhubio-catalog<\/span>   OperatorHub<\/span>.io<\/span> Community<\/span> Catalog<\/span> OperatorHub<\/span>.io<\/span>    1m<\/span>\n<\/code><\/span>Code language:<\/span> CSS<\/span> (<\/span>css<\/span>)<\/span><\/small><\/pre>\n\n\n
    Next, check if the catalog is READY:<\/p>\n\n\n
    oc describe catalogsource operatorhubio-catalog -n openshift-marketplace\n<\/code><\/span><\/pre>\n\n\n
    Look for a Connection state: READY<\/code>.<\/p>\n\n\n\n
    \"\"<\/figure>\n\n\n\n
    \n\n\n\n
    \ud83d\udd04 Step 5: Wait for OperatorHub UI to Sync<\/h2>\n\n\n\n
    It may take 2\u20135 minutes for the UI to display new operators.<\/p>\n\n\n\n
      \n
    • Go to Operators \u2192 OperatorHub<\/strong><\/li>\n\n\n\n
    • Use the Publisher<\/strong> filter and search for OperatorHub.io<\/code><\/li>\n\n\n\n
    • You\u2019ll now see many new operators available to install<\/li>\n<\/ul>\n\n\n\n
      You can also list them via CLI:<\/p>\n\n\n
      oc get<\/span> packagemanifests -n openshift-marketplace | grep operatorhubio\n<\/code><\/span>Code language:<\/span> JavaScript<\/span> (<\/span>javascript<\/span>)<\/span><\/small><\/pre>\n\n\n
      \n\n\n\n
      \u2705 Step 6: Install an Operator (Optional)<\/h2>\n\n\n\n
      Once the new operators appear, you can install them from the console or via CLI. Example for installing the PostgreSQL Operator<\/strong>:<\/p>\n\n\n
      oc create -f - <<EOF\napiVersion: operators.coreos.com\/v1alpha1\nkind: Subscription\nmetadata:\n  name: postgresql-subscription\n  namespace<\/span>: my<\/span>-app<\/span>-namespace<\/span>\nspec<\/span>:\n  channel<\/span>: stable<\/span>\n  name<\/span>: postgresql<\/span>\n  source<\/span>: operatorhubio<\/span>-catalog<\/span>\n  sourceNamespace<\/span>: openshift<\/span>-marketplace<\/span>\n  installPlanApproval<\/span>: Automatic<\/span>\nEOF<\/span>\n<\/code><\/span>Code language:<\/span> PHP<\/span> (<\/span>php<\/span>)<\/span><\/small><\/pre>\n\n\n
      \n\n\n\n
      \ud83e\uddf9 (Optional) Step 7: Clean Up<\/h2>\n\n\n\n
      To remove the catalog if needed:<\/p>\n\n\n
      oc delete<\/span> catalogsource operatorhubio-catalog -n openshift-marketplace\n<\/code><\/span>Code language:<\/span> JavaScript<\/span> (<\/span>javascript<\/span>)<\/span><\/small><\/pre>\n\n\n
      \n\n\n\n
      <\/p>\n","protected":false},"excerpt":{"rendered":"
      Here’s a complete, step-by-step tutorial \u2014 with explanations \u2014 to add OperatorHub.io operators to OpenShift by creating a custom CatalogSource pointing to their community catalog image from Quay.io. \ud83c\udfaf Goal… <\/p>\n","protected":false},"author":1,"featured_media":0,"comment_status":"open","ping_status":"","sticky":false,"template":"","format":"standard","meta":{"_joinchat":[],"footnotes":""},"categories":[5153],"tags":[],"class_list":["post-49766","post","type-post","status-publish","format-standard","hentry","category-openshift"],"_links":{"self":[{"href":"https:\/\/www.devopsschool.com\/blog\/wp-json\/wp\/v2\/posts\/49766","targetHints":{"allow":["GET"]}}],"collection":[{"href":"https:\/\/www.devopsschool.com\/blog\/wp-json\/wp\/v2\/posts"}],"about":[{"href":"https:\/\/www.devopsschool.com\/blog\/wp-json\/wp\/v2\/types\/post"}],"author":[{"embeddable":true,"href":"https:\/\/www.devopsschool.com\/blog\/wp-json\/wp\/v2\/users\/1"}],"replies":[{"embeddable":true,"href":"https:\/\/www.devopsschool.com\/blog\/wp-json\/wp\/v2\/comments?post=49766"}],"version-history":[{"count":2,"href":"https:\/\/www.devopsschool.com\/blog\/wp-json\/wp\/v2\/posts\/49766\/revisions"}],"predecessor-version":[{"id":59009,"href":"https:\/\/www.devopsschool.com\/blog\/wp-json\/wp\/v2\/posts\/49766\/revisions\/59009"}],"wp:attachment":[{"href":"https:\/\/www.devopsschool.com\/blog\/wp-json\/wp\/v2\/media?parent=49766"}],"wp:term":[{"taxonomy":"category","embeddable":true,"href":"https:\/\/www.devopsschool.com\/blog\/wp-json\/wp\/v2\/categories?post=49766"},{"taxonomy":"post_tag","embeddable":true,"href":"https:\/\/www.devopsschool.com\/blog\/wp-json\/wp\/v2\/tags?post=49766"}],"curies":[{"name":"wp","href":"https:\/\/api.w.org\/{rel}","templated":true}]}}