1. Deploy Talos Linux and bootstrap a Kubernetes cluster
Install our distribution of Talos Linux on a set of virtual machines. Use Talm CLI to bootstrap a Kubernetes cluster, ready for Cozystack.
Before you begin
Make sure that you have nodes (bare-metal servers or VMs) that fit the hardware requirements.
Objectives
On this step of the tutorial you will bootstrap a Kubernetes cluster on Talos Linux, and make sure that it is ready to install Cozystack.
The tutorial will guide you through the following steps:
- Install Talos Linux on your nodes or start it from another OS using
kexec
. - Bootstrap Talos to run a Kubernetes cluster.
- Get a kubeconfig, check cluster status, and prepare to install Cozystack.
1 Install Talos Linux
Boot your machines with Talos Linux image in one of these ways:
- Quick-start Talos from another running Linux OS.
- Install using temporary DHCP and PXE servers running in Docker containers.
- Install using ISO.
2 Bootstrap Talos Cluster
Bootstrap your Talos Linux cluster using one of the following tools:
- Talm, for a declarative way of cluster management.
- talosctl, for using native
talosctl
tool. - talos-bootstrap, for an interactive walkthrough.
Talm is a utility tool for bootstrapping and managing Talos clusters in a declarative way.
Visit the releases page for the latest Talm binaries or use the universal installation script:
curl -sSL https://github.com/cozystack/talm/raw/refs/heads/main/hack/install.sh | sh -s
talm --help
talos-bootstrap is an interactive script for bootstrapping Kubernetes clusters on Talos OS.
sudo curl -fsSL -o /usr/local/bin/talos-bootstrap \
https://github.com/cozystack/talos-bootstrap/raw/master/talos-bootstrap
sudo chmod +x /usr/local/bin/talos-bootstrap
talos-bootstrap --help
Last modified 2025-07-30: [style] Fix spelling for "bare-metal nodes" vs "bare metal" (7ef8cdb)