Cozystack Deployment Guide: from Infrastructure to a Ready Cluster

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.

Air-gapped Environment

Cozystack can be installed in an isolated environment without direct Internet access. The key difference of such installation is in using proxy registries for images:

1. Install Talos Linux on bare metal or VMs running Linux or having no OS at all.
2. Configure Talos nodes for air-gap and bootstrap a Kubernetes cluster.
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:

• Hetzner
• Oracle Cloud Infrastructure (OCI)
• Servers.com

Upgrading and Post-deployment Configuration

After you’ve deployed a cluster, proceed to the Cluster Administration section for the next actions:

• Configure OIDC
• Deploy Cozystack in a Multi-Datacenter Setup
• Upgrading Cozystack