Requirements and Toolchain
Prepare infrastructure and install the toolchain.
Toolchain
You will need the following tools installed on your workstation:
talosctl, the command line client for Talos Linux.
kubectl, the command line client for Kubernetes.
Talm, Cozystack’s own configuration manager for Talos Linux:
curl -sSL https://github.com/cozystack/talm/raw/refs/heads/main/hack/install.sh | sh -s
Hardware Requirements
To run this tutorial, you will need the following setup:
Cluster nodes: three bare-metal servers or virtual machines in the following minimal configuration:
- CPU: 4 cores,
x86
architecture. - RAM: 16 GiB.
- Hard disks:
- HDD1: 32GiB
Primary disk, used for Talos Linux, etcd storage, and downloaded images. - HDD2: 100GiB
Secondary disk, used for user application data.
- HDD1: 32GiB
- OS:
- Any Linux distribution, for example, Ubuntu.
- There are other installation methods which require either any Linux or no OS at all to start.
- Any Linux distribution, for example, Ubuntu.
- Networking:
- Routable FQDN domain.
If you don’t have one, you can use nip.io with dash notation - Located in the same L2 network segment.
- Routable FQDN domain.
- Anti-spoofing disabled.
It is required for MetalLB, the load balancer used in Cozystack. - If using virtual machines, there are extra requirements:
- CPU passthrough enabled and CPU model set to
host
in the hypervisor settings. - Nested virtualization enabled.
Required for virtual machines and tenant kubernetes clusters.
- CPU passthrough enabled and CPU model set to
For a more detailed explanation of hardware requirements for different setups, refer to the Hardware Requirements
Last modified 2025-08-20: [docs] Add boot-to-talos, improve consistency (22ce6a8)