Connect cluster to control plane

The fastest way to get started with Truefoundry is to attach your own cluster as the workload cluster to the Truefoundry hosted control plane. To get started with the installation, you will need the following information:

  1. The Control Plane Dashboard ( if you are using the Truefoundry hosted one)
  2. The Kubernetes cluster Kubecontext on your local machine.
  3. Your org name which is created by Truefoundry prior to onboarding (Reach out to us on Slack you don't have one). This will create your own org that can be accessed at and you can login to the portal.

Add the cluster on the control plane Integrations section

Once you add the cluster, it should show up on the Clusters page with a disconnected status. The next step is to get the cluster token for this cluster.

Get Cluster token

Let's say the cluster token is cluster-token

Install the servicefoundry library

pip install servicefoundry

Login as admin to your org

sfy login --host

Install agent on the cluster

Let's say your org name is yourcompany. In that case, run the command:

sfy bootstrap cluster --cluster-token=cluster-token --org=yourcompany --control-plane-url=

The CLI will guide you through the installation process. Once the agent pods are up in the tfy-agent namespace. You can check the status of the pods using:

kubectl get pods -n tfy-agent

Cluster shows up as Connected on Control Plane

Once the tfy-agent pods are running, the status of the cluster should change to Connected on the control plane dashboard.