Help us improve your experience.

Let us know what you think.

Do you have time for a two-minute survey?


Create an ACM Hub Cluster

Use this example procedure to create an ACM hub cluster.

The ACM hub cluster provides centralized management to its managed clusters. You can configure any cluster (including a single node OpenShift cluster) to be the hub cluster. The hub cluster can run any CNI.

We provide this example procedure purely for informational purposes. See Red Hat ACM documentation for the official procedure.

Run this procedure from the installation machine.

  1. Create an OCP cluster using the method of your choice. This cluster can run the default CNI. There is no need to install CN2 on this cluster.

    In this example procedure, we assume the following:

    • This cluster is a single node OpenShift cluster running the default CNI and reachable at We'll refer to this as the hub cluster in the rest of this procedure.

    • The kubeconfig for this cluster is at its default location (~/.kube/config) on the installation machine.

    • The cluster SSH key is at its default location (~/.ssh/id_rsa and ~/.ssh/ on the installation machine.

  2. Create network storage that is accessible by this hub cluster and the managed clusters.
    One way to do this is to deploy an NFS server (minimum 120 GB) in conjunction with an external provisioner. For example, you can deploy an NFS Subdir External Provisioner to support dynamic provisioning of persistent volumes using an existing and already configured NFS server. This is described in
  3. Install the multicluster engine (MCE) operator. This is the OCP operator that provides the ACM hub functionality. (This operator is not related to CN2 multicluster.)
    1. Create the multicluster engine operator manifest.
      We'll save this as hub-mce.yaml.
    2. Install the operator.
  4. Create the MultiClusterEngine custom resource.
    1. Create the MultiClusterEngine custom resource manifest.
      We'll save this as hub-mce-cr.yaml.
    2. Create the resource.
  5. Configure the assisted service component.
    1. Create the assisted service manifest.
      For example:where:
      • <ssh-private-key> is the SSH private key (that is, the contents of ~/.ssh/id_rsa)

      • <pull-secret> is the pull secret that you downloaded from Red Hat

      We'll save this as hub-assisted-service.yaml.
    2. Create the assisted service component.
  6. Verify that all the multicluster engine components are running.
You've created the hub cluster and configured it for ACM. You can now install the managed clusters.