KUP6S Documentation¶
Kubernetes Cluster KUP6S managed by Klein & Partner KG.
Welcome to the KUP6S cluster documentation. This documentation covers everything from initial deployment to day-to-day operations and deep architectural understanding.
About KUP6S¶
KUP6S is a production Kubernetes cluster running on Hetzner Cloud, built with the kube-hetzner project. It provides a highly available, multi-datacenter platform for running containerized applications.
Key Features:
K3S on openSUSE MicroOS
Multi-architecture (ARM64 + AMD64)
3 control planes across 3 datacenters (Helsinki, Nuremberg, Falkenstein)
Wireguard-encrypted pod-to-pod communication
Comprehensive monitoring with Prometheus, Grafana, and Loki
GitOps deployments via ArgoCD
Infrastructure-as-Code with OpenTofu
Documentation Structure¶
This documentation follows the Diátaxis framework, organizing content into four categories based on what you need:
Learning-oriented: Step-by-step lessons to build skills
Start here if you’re new to KUP6S
Goal-oriented: Solutions to specific problems
Use these when you need to accomplish something
Information-oriented: Technical specifications and configurations
Consult when you need detailed information
Understanding-oriented: Concepts and design decisions
Read to deepen your understanding
Quick Links¶
Getting Started¶
Deploy your first cluster - Complete tutorial for new users
Environment setup - Configure your local environment
Why Kube-Hetzner? - Understand our infrastructure choices
Common Tasks¶
Apply infrastructure changes - Safely update the cluster
Create S3 bucket with Crossplane - Manage object storage
Query Loki logs - Find logs across the cluster
Architecture¶
Architecture overview - High-level system design
Network topology - Understand the network
Component reference - Detailed component documentation
Deployed Applications¶
The cluster hosts various applications and services. Each deployment has its own dedicated documentation following the same Diátaxis structure (tutorials, how-to guides, reference, and explanation).
For a complete list of deployed applications and their documentation, see the Deployments section.
Table of Contents¶
Documentation
- Tutorials
- How-To Guides
- Setup kup6s Workspace
- Set Up Your Local Environment
- Access kubectl via SOCKS5 Proxy
- Manage Contexts with ktx
- Apply Infrastructure Changes Safely
- Create S3 Buckets with Crossplane
- Configure External Secret Stores
- Bootstrap Application Secrets with ESO
- Create a Bootstrap Script for Application Secrets
- Work as a Capsule Tenant
- Back Up K3S Encryption Keys
- Explore the Cluster with k9s
- Query Logs with Loki
- Query Historical Metrics with Thanos
- Choose the Right Storage Class
- Deploy Multi-Architecture Applications
- Troubleshoot Nodes Stuck After K3S Upgrade
- Troubleshoot K3S Upgrade Failures
- Reference
- Explanation
- Architecture Overview
- Infrastructure Layering
- Monitoring Architecture
- Workspace Structure
- Why Kube-Hetzner?
- Infrastructure as Code
- CDK8S: Infrastructure as Code for Kubernetes
- Helm Deployment Strategies: K3s HelmChart vs cdk8s Helm
- ArgoCD and GitOps Deployment
- Security Model
- Application Secrets Architecture
- Capsule Multi-Tenancy
- Storage Architecture and Tiers
- Resource Management and QoS in Kubernetes
- Extra Manifests Organization Strategy
- Traefik TLS Termination for Mail Protocols
- Longhorn Resilience Configuration
- Deployed Applications
- Capsule Multi-Tenancy
- CloudNativePG Operator
- Create a PostgreSQL Cluster
- Configure Automated Backups
- Manual Backup and Restore
- Update CNPG Operator Version
- Troubleshoot CNPG Issues
- CNPG Operator Architecture
- Backup and Recovery Strategy
- High Availability Configuration
- Storage Strategy
- Resource Management
- Configuration Options
- Project Structure
- CDK8S Constructs API
- Cluster CRD Reference
- GitLab BDA
- Architecture Overview
- ArgoCD GitOps Workflow for GitLab BDA
- CDK8S Approach for GitLab BDA
- Storage Architecture for GitLab BDA
- GitLab Components Architecture
- Harbor Container Registry Integration
- Security Model
- Monitoring & Observability
- ArgoCD Configuration
- Configuration
- CDK8S Constructs API
- GitLab BDA Secrets Configuration
- S3 Buckets
- Resource Requirements
- Environment Variables
- Version Compatibility
- Endpoints & Ports
- Troubleshooting
- kubectl Commands
- How-To Guides
- Tutorials
- kup6s-pages
- Mailu Mail Server
- Monitoring Stack
- Setup: Grafana Admin Password with ESO
- Upgrade Monitoring Components
- Scale Monitoring Resources
- Debug Monitoring Issues
- Monitoring Stack Architecture Overview
- Prometheus and Thanos Integration
- Loki Architecture and SimpleScalable Mode
- CDK8S Approach for Monitoring Stack
- Resource Optimization and Sizing Methodology
- Storage Architecture for Monitoring Stack
- Configuration Reference
- Constructs API Reference
- Helm Values Reference
- Resource Requirements Reference
- S3 Buckets Reference
- Troubleshooting Guide
- Nextcloud
Last updated: 2025-10-21 Cluster version: kube-hetzner v2.17.4 K3S version: (managed by kube-hetzner)