Skip to main content
Talos Director is in Limited Availability. Limited Availability customers receive full production support and work directly with Sidero Labs engineering during onboarding. General availability is planned for January 2027, and the console is changing quickly until then, so details on these pages may differ from what you see.To request access, visit siderolabs.com/getdirector.
Clusters in Talos Director are logical groupings of KVM hosts. Each host remains a standalone system with access to shared storage; Talos Director uses the cluster boundary to make virtual machine placement decisions, balance load with the Resource Scheduler (RS), and restart workloads on surviving hosts through High Availability (HA). Use the Clusters page to answer fleet-level questions — is every cluster healthy, and how much capacity is committed? — before drilling into an individual cluster’s hosts, VMs, storage, or upgrade state.

The All Clusters view

Navigate to Compute > Clusters (/clusters) to see every cluster in one table.

Columns

The table shows the following columns.
CPU and memory percentages measure allocation, not live utilization. A cluster showing 289% CPU is oversubscribed by design — compare this figure against actual host utilization on the cluster’s Performance tab before adding capacity.

Controls

The controls above the table let you search, shape, and export the view:
  • Filter clusters… — filter the table with free text or query-style expressions, for example health_status:healthy.
  • Columns — choose which columns are visible.
  • Export CSV — download the current view for reporting or offline analysis.
  • Create Cluster — define a new cluster boundary for hosts you plan to add.
  • Items per page — page through large fleets at 25, 50, 100, or All rows.
  • Global search — the top-bar search spans VMs, hosts, networks, and users, and supports scoped queries such as vm:name.

Create a cluster

Select the + Create Cluster button to provision a new KVM cluster. Complete the following fields. The Create Cluster dialog

The cluster detail screen

Click a cluster name to open its detail screen. The header summarizes the cluster’s configuration and scale at a glance: Below the header, tabs separate each operational dimension of the cluster.

Hosts

Lists the hosts that belong to the cluster, with status, agent version, CPU and memory usage, VM count, and uptime. Use this tab to assess member health without returning to the global Hosts inventory. The table supports the same column selection, refresh, and CSV export controls as the All Clusters view.

Virtual Machines

Lists every VM placed in the cluster, with power state, guest status, resources, and storage consumption. This is the fastest way to scope the blast radius of a cluster-level issue.

Storage

Shows the storage pools serving the cluster, with type, capacity, used and available space, and usage percentage. You can add a storage pool directly from this tab, keeping storage provisioning in the context of the cluster that will consume it. For details on pools, see Storage Pools.

Profiles

Manages the cluster configuration profile and the default per-OS CPU profiles applied to new virtual machines. Defining profiles at the cluster level standardizes how workloads are built and keeps per-host or per-VM overrides explicit exceptions rather than the norm.

Resource Scheduler Rules

Defines affinity and anti-affinity rules that constrain automated placement. Use affinity rules to keep chatty workloads together and anti-affinity rules to keep redundant workloads (for example, the members of a database cluster) on separate hosts. Each rule shows its type, scope, member VMs or hosts, and status. Click Create Rule to add one.

Updates

Runs rolling operating system upgrades across the cluster’s immutable hosts. A rolling upgrade updates hosts one at a time, so workloads keep running while the cluster converges on the new version. Start an upgrade with Start Rolling Upgrade and track progress from this tab.
Confirm the cluster has spare capacity before starting a rolling upgrade. Each host is taken out of service in turn, and its workloads must fit on the remaining hosts.

Services

Shows the platform services running on the cluster, the effective state of each, and its provenance — whether the setting is inherited from the platform default or overridden for this cluster. This makes configuration drift visible and auditable.

Performance

Charts cluster-wide utilization over selectable time ranges (1 hour to 30 days, or a custom range) and resolutions. Use this tab to distinguish genuine saturation from allocation-level overcommit, and click View hosts to break the aggregate down by member host.