Cozystack Deployment Guide: from Infrastructure to a Ready Cluster

Learn how to deploy a Cozystack cluster using Talos Linux and Kubernetes. This guide covers installation, configuration, and best practices for a reliable and secure Cozystack deployment.

Cozystack Tutorial

If this is your first time installing Cozystack, consider going through the Cozystack tutorial. It shows the shortest way to getting a proof-of-concept Cozystack cluster.

Generic Installation Path

Installing Cozystack on bare-metal servers or VMs involves three consecutive steps. Each of them has a variety of options, and while there is a recommended option, we provide alternatives to make the installation process flexible:

  1. Install Talos Linux on bare metal or VMs running Linux or having no OS at all.
  2. Install and bootstrap a Kubernetes cluster on top of Talos Linux.
  3. Install and configure Cozystack on the Kubernetes cluster.

Provider-specific Installation

There are specific guides for cloud providers, covering all the steps from preparing infrastructure to installing and configuring Cozystack. If that’s your case, we recommend using the guides below:

Hardware requirements

Define the hardware requirements for your Cozystack use case.

Installing Talos Linux on Bare Metal or Virtual Machines

Step 1: Installing Talos Linux on virtual machines or bare metal, ready to bootstrap Cozystack cluster.

Installing and Configuring Kubernetes Cluster on Talos Linux

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

Installing and Configuring Cozystack

Step 3: Installing Cozystack on a Kubernetes Cluster, getting administrative access, and configuring the dashboard.

Deploying Cozystack Cluster on Clouds and Hosting Providers

Guides for deploying Cozystack clusters on specific cloud and hosting providers.

Last modified 2025-08-20: [docs] Add boot-to-talos, improve consistency (22ce6a8)