0. Requirements and Toolchain
Prepare hardware and install the toolchain.
Cozystack Tutorial: 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.
Tutorial Steps
This tutorial is divided into several steps. We recommend following them in the specified order, completing each step before starting the next one:
| Step | Description |
|---|---|
| 0. Preparing infrastructure and tools | Prepare VMs and install required CLI tools on your machine before running this tutorial. |
| 1. Installing Talos Linux and 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. |
| 2. Installing and configuring Cozystack | Install Cozystack, get administrative access, perform basic configuration, and enable the UI dashboard. |
| 3. Creating a user tenant | Create a user tenant, the foundation of RBAC in Cozystack, and get access to it via dashboard and Cozystack API. |
| 4. Creating managed applications | Start using Cozystack: deploy a virtual machine, managed application, and a tenant Kubernetes cluster. |
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.
2. Install and Configure Cozystack
Install Cozystack, get administrative access, perform basic configuration, and enable the UI dashboard.
3. 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.
4. 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-07-20: [docs] Make step descriptions in the tutorial match pages' own descriptions (fbda436)