Requirements and Toolchain
Prepare infrastructure and install the toolchain.
Getting Started with Cozystack: Deploying Private Cloud from Scratch
Make your first steps, run a home lab, build a POC with Cozystack.
This tutorial will guide you through your first deployment of a Cozystack cluster. Along the way, you will get to know about key concepts, learn to use Cozystack via dashboard and CLI, and get a working proof-of-concept.
The tutorial is divided into several steps. Make sure to complete each step before starting the next one:
| Step | Description |
|---|---|
| Requirements: prepare infrastructure and tools | Prepare infrastructure and install required CLI tools on your machine before running this tutorial. |
| 1. Install Talos Linux | Install a Cozystack-specific distribution of Talos Linux using
boot-to-talos, likely the easiest installation method. |
| 2. Install and bootstrap a Kubernetes cluster | Bootstrap a Kubernetes cluster using Talm, the Talos configuration management tool made for Cozystack. |
| 3. Install and configure Cozystack | Install Cozystack, get administrative access, perform basic configuration, and access the Cozystack dashboard. |
| 4. Create a tenant for users and teams | Create a user tenant, the foundation of RBAC in Cozystack, and get access to it via dashboard and Cozystack API. |
| 5. Deploy managed applications | Start using Cozystack: deploy a virtual machine, managed application, and a tenant Kubernetes cluster. |
1. Install Talos Linux
Install Talos Linux on any machine using cozystack/boot-to-talos.
2. Install and Bootstrap a Kubernetes cluster
Use Talm CLI to bootstrap a Kubernetes cluster, ready for Cozystack.
3. Install and Configure Cozystack
Install Cozystack, get administrative access, perform basic configuration, and enable the UI dashboard.
4. Create a User Tenant and Configure Access
Create a user tenant, the foundation of RBAC in Cozystack, and get access to it via dashboard and Cozystack API.
5. Deploy Managed Applications, VMs, and tenant Kubernetes cluster
Start using Cozystack: deploy a virtual machine, managed application, and a tenant Kubernetes cluster.
Last modified 2025-08-20: [docs] Add boot-to-talos, improve consistency (22ce6a8)