Installation Process Overview
Installation stands up the platform in a Kubernetes cluster. The steps run in a strict order: each stage depends on the one before it. Completing them out of sequence causes installation failures that are hard to diagnose, so follow the order below as written.
The logical order is: onboarding, SSO configuration, cluster provisioning, data plane installation, and gateway installation. Cluster provisioning is the customer's responsibility and falls outside Tetrate support.
Installation sequence
Step 1
Onboarding
Sign in to the provided management plane and complete the Admin Dashboard onboarding wizard: organization details, providers, and the service account credential the data plane needs.
Onboarding guide →Step 2
SSO configuration
Connect an OIDC-compliant identity provider for single sign-on. This is completed as part of the onboarding wizard and is required before data plane installation.
Configure SSO →Step 3
Create cluster
Provision the Kubernetes infrastructure that hosts the data plane. Cluster provisioning is the customer's responsibility and is not covered by Tetrate support.
Review prerequisites →Step 4
Data plane installation
Install the Controller and Agent Router on the provisioned cluster. Guides cover Azure (AKS), AWS (EKS), and GCP (GKE), using either the tare CLI or Helm.
Data plane guides →Step 5
Gateway installation
Install the data plane gateway components that manage inbound access to the data plane and configure request routing.
Gateway installation →Post-install