Create a cluster
Create the cluster your projects and apps run on.
A cluster is a set of servers at one provider, in one region. Your projects and apps run on it. You need credit on your balance first: see Sign up.
Fill in the form
Open Infrastructure in the sidebar and select Create Cluster (or New Cluster once you have one).
Basics
- Cluster name: for example
production. - Environment: the environment the cluster belongs to. New environment creates one.
- Provider and Region: where the servers run, such as Hetzner in
fsn1.
Node Pools
The form starts with two pools of 3 servers each:
control-plane(role Control Plane) runs Kubernetes itself.workers(role Worker) runs your apps.
Pick a Server type for each pool and change the Node count if you want. For a first test, one control-plane server and one or two workers are enough. A cluster needs at least one Worker or Hybrid pool.
Load Balancers (optional)
Add an external load balancer from the provider to receive traffic from the internet. Inside the cluster, Traefik routes it to your apps. The form recommends a type for your pools.
Check the cost and create
The summary on the side shows what is Due now and what is billed after that. Most server types are billed hourly. Some are rented for a fixed term, and the summary then shows a Commitment with its term and total. See Billing.
Fixed-term servers
A server type with a Commitment is charged for its whole term, even if you remove the server earlier. For a first test, pick an hourly type.
Accept the provider's Terms of Service, then select Create cluster. If your balance is too low, the summary says so, with a Top up your balance link.
Verify
The cluster appears on the Infrastructure canvas right away. Its state is
provisioning while the servers start and join, then running. This takes a
few minutes.
Next: create a project.
To describe the cluster as a file instead, see Clusters and pools in IaC. For pools, autoscaling and reserved servers, see the dedicated clusters guide.