Install Cozystack v1.x
Install Cozystack v1.x using Package-based configuration, set up storage and networking, and access the dashboard.
3. Install and Configure Cozystack
Install Cozystack, configure storage and networking, and access the dashboard.
This guide walks you through installing Cozystack on top of a Kubernetes cluster.
Choose Your Version
Cozystack has two major versions with different configuration approaches:
Cozystack v1.x (Recommended)
The latest version using Package-based configuration.
- Unified configuration through a single Package resource
- New bundle variants:
isp-full,isp-hosted,distro-full - Managed by
cozystack-operator - Recommended for new installations
Cozystack v0.x (Legacy)
Previous version using ConfigMap-based configuration.
- Configuration through ConfigMap in
cozy-system - Bundle names:
paas-full,paas-hosted - For existing v0.x installations
What You’ll Learn
Both installation guides cover:
- Preparing configuration (Package for v1.x or ConfigMap for v0.x)
- Installing Cozystack
- Configuring storage with LINSTOR
- Setting up networking (MetalLB or public IPs)
- Deploying etcd, ingress, and monitoring
- Accessing the Cozystack dashboard
Prerequisites
Before starting, ensure you have completed:
Choose the version that matches your needs and proceed with the appropriate installation guide.
Install Cozystack v0.x
Install Cozystack v0.x using ConfigMap-based configuration, get administrative access, and enable the UI dashboard.