Chapter 1. Installing Red Hat Developer Hub on OpenShift Dedicated on GCP using the Operator


You can install Developer Hub on OpenShift Dedicated on GCP using the Red Hat Developer Hub Operator.

Prerequisites

  • You have a valid GCP account.
  • Your OpenShift Dedicated cluster is running on GCP. For more information, see Creating a cluster on GCP in Red Hat OpenShift Dedicated documentation.
  • You have administrator access to OpenShift Dedicated cluster and GCP project.

Procedure

  1. In the OpenShift Container Platform web console menu, go to Operators > OperatorHub.
  2. In the Filter by keyword field, enter Developer Hub and click the Red Hat Developer Hub Operator card.
  3. On the Red Hat Developer Hub Operator page, click Install.
  4. After the installation completes, navigate to Installed Operators and select Red Hat Developer Hub Operator.
  5. Provision your custom configuration:

    apiVersion: v1
    kind: ConfigMap
    metadata:
      name: app-config-rhdh
    data:
      "app-config-rhdh.yaml": |
        app:
          title: Red Hat Developer Hub
          baseUrl: https://__<my_developer_hub_url>__
        backend:
          auth:
            externalAccess:
                - type: legacy
                  options:
                    subject: legacy-default-config
                    secret: "${BACKEND_SECRET}"
          baseUrl: https://__<my_developer_hub_url>__
          cors:
            origin: https://__<my_developer_hub_url>__
    Copy to Clipboard Toggle word wrap

    You must create a config map named app-config-rhdh and a Kubernetes Secret containing the BACKEND_SECRET. These resources are used by the Developer Hub instance for authentication and application settings.

    For further steps, see Provisioning your custom Red Hat Developer Hub configuration.

  6. Create a config map named app-config-rhdh that includes your app-config.yaml as shown:

    apiVersion: v1
    kind: ConfigMap
    metadata:
      name: app-config-rhdh
    data:
      "app-config-rhdh.yaml": |
        app:
          title: Red Hat Developer Hub
          baseUrl: https://__<my_developer_hub_url>__
        backend:
          auth:
            externalAccess:
                - type: legacy
                  options:
                    subject: legacy-default-config
                    secret: "${BACKEND_SECRET}"
          baseUrl: https://__<my_developer_hub_url>__
          cors:
            origin: https://__<my_developer_hub_url>__
    Copy to Clipboard Toggle word wrap
  7. Create a secret named my-rhdh-secrets and add a key named BACKEND_SECRET with a Base64-encoded string as value:

    apiVersion: v1
    kind: Secret
    metadata:
      name: my-rhdh-secrets
    stringData:
      # TODO: Add the necessary auth secrets for service-to-service auth setup
      BACKEND_SECRET: "xxx" # Replace with your Base64-encoded secret
    Copy to Clipboard Toggle word wrap
  8. Return to the Developer Hub Operator page and click Create New Instance.
  9. Specify the name and target namespace for the Developer Hub deployment.
  10. Configure required options such as Git integration, secrets, and user permissions.
  11. Review the configuration, select deployment options, and click Create.

Verification

  • To access the Developer Hub, navigate to the Developer Hub URL provided in the OpenShift Container Platform web console.
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