Installing and Configuring Kubernetes Cluster on Talos Linux

Step 2: Installing and configuring a Kubernetes cluster on Talos Linux nodes, ready for Cozystack installation.

The second step in deploying a Cozystack cluster is to install and configure a Kubernetes cluster on Talos Linux nodes. A prerequisite to this step is having installed Talos Linux. The result is a Kubernetes cluster installed, configured, and ready to install Cozystack.

If this is your first time installing Cozystack, start with the Cozystack tutorial.

Installation Options

There are several methods to configure Talos nodes and bootstrap a Kubernetes cluster:

  • Recommended: using Talm, a declarative CLI tool, which has ready presets for Cozystack and uses the power of Talos API under the hood.
  • Using talos-bootstrap, an interactive script for bootstrapping Kubernetes clusters on Talos OS.
  • Using talosctl, a specialized command line tool for managing Talos.
  • Air-gapped installation is possible with Talm or talosctl.

If you encounter problems with installation, refer to the Troubleshooting section.

Further Steps


Use Talm to bootstrap a Cozystack cluster

talm is a declarative CLI tool made by Cozystack devs and optimized for deploying Cozystack.
Recommended for infrastructure-as-code and GitOps.

Use talos-bootstrap script to bootstrap a Cozystack cluster

talos-bootstrap is a CLI for step-by-step cluster bootstrapping, made by Cozystack devs.
Recommended for first deployments.

Use talosctl to bootstrap a Cozystack cluster

talosctl is the default CLI of Talos Linux, requiring more boilerplate code, but giving full flexibility in configuration.

Bootstrap an Air-Gapped Cluster

Bootstrap a Cozystack cluster in an isolated (air-gapped) environment with container registry mirrors.

Troubleshooting Kubernetes Installation

Instructions for resolving typical problems that can occur when installing Kubernetes with talm, talos-bootstrap, or talosctl.