Skip to content


The steps described below capture the steps needed to import a cluster manually using the Rafay Console. Watch a video showcasing the Import of an existing AWS EKS Cluster into Rafay.


Kubernetes v1.14.1 or higher is the minimum supported version for imported clusters.

Step 1: Start Import

  • In the Rafay Console, click on New Cluster
  • Select "Import Existing Kubernetes Cluster" and click Continue
  • Select "Environment" based on where the cluster is provisioned
  • Select "Kubernetes Distribution"
  • Give it a name and Click on "Continue"

Below illustration shows an example of importing existing EKS cluster.

Import Cluster

Step 2: Provide Cluster Details

In the wizard on the Rafay Console,

  • Select a location for the cluster from the dropdown
  • Select the blueprint from the drop down (default blueprint will be used if nothing is specified)
  • If a custom blueprint is selected select the version for the blueprint

New Cluster Initial Config

Step 3: Register Cluster with Rafay

You will now be presented with a cluster registration step where the user has to deploy a uniquely generated "Rafay Bootstrap YAML" file to their cluster using "KubeCTL". This process initiates the registration process of the imported cluster with the Rafay Controller, deploys all the required software components for the Rafay k8s operator and configured cluster blueprint.

  • Download the YAML file generated for the cluster
  • Deploy the YAML file to your cluster using "kubectl"


You must have cluster-admin privilege to import the cluster into Rafay.

If successful, you should see output similar to the image below

Register Cluster Kubectl Output

Once registration starts, and the Rafay in-cluster components are successfully deployed,

  • The cluster will check in with the controller
  • The namespaces will be synchronized
  • Finally, the configured blueprint will be applied to the imported cluster.

Register Cluster with Rafay

Import Successful

Once all the steps are complete and if the import process was successful, you should see details about the cluster on the Ops Console. The imported cluster is now managed by the Rafay Controller.

Imported Cluster