3.6 KiB
KiteStacks Homelab Documentation v1.3
Overview
KiteStacks Homelab is a self-hosted infrastructure platform designed around Kubernetes, GitOps, observability, AI services, digital libraries, productivity applications, and identity management.
The homelab is currently operating in a hybrid state:
- Existing applications continue running in Docker
- Kubernetes (K3s) has been deployed successfully
- Forgejo serves as the private Git platform
- GitOps repository has been established
- Migration to Kubernetes will occur incrementally
Infrastructure
Primary Server
Hostname:
assassin
Role:
Primary Homelab Server
Kubernetes Control Plane
Docker Host
GitOps Management Node
Operating System:
Debian 13
Kubernetes
Distribution
K3s
Version:
v1.35.5+k3s1
Status:
Ready
Verification:
kubectl get nodes
Expected Result:
assassin Ready control-plane
Kubernetes Components
Currently Running:
- CoreDNS
- Metrics Server
- Local Path Provisioner
- Traefik Ingress Controller
Future Components:
- FluxCD
- Longhorn
- Cert-Manager
- Cloudflare Tunnel
- Authentik
- Prometheus Operator
GitOps
Git Platform
Forgejo
Repository:
https://gitforge.kitestacks.com/kenpat/kitestacks-homelab.git
Visibility:
Private
Purpose:
- Infrastructure as Code
- Kubernetes manifests
- Documentation
- Application deployment
- Disaster recovery
Repository Structure
kitestacks-homelab
├── apps
├── clusters
│ └── assassin
├── docs
├── infrastructure
└── media
Current Docker Applications
Dashboard
- Homepage
Library Services
- Kavita
Knowledge Management
- Linkding
Source Control
- Forgejo
Monitoring
- Grafana
- Prometheus
Planned Services
Identity
- Authentik
AI
- Open WebUI
- LiteLLM
Productivity
- Plane
- OpenProject (evaluation)
Media
- Audiobookshelf
Kavita
Library Location
/home/kenpat/library/books
Current Status
Running in Docker.
Future migration planned to Kubernetes.
Cloudflare
Domain
kitestacks.com
Current usage:
- Reverse proxy
- Public application access
- DNS management
Future usage:
- Kubernetes ingress
- Cloudflare Tunnel
- Zero Trust
Monitoring Strategy
Primary Monitoring:
- Grafana
Metrics Collection:
- Prometheus
Future Monitoring:
- Kubernetes cluster metrics
- Longhorn metrics
- Application metrics
- Node metrics
Migration Roadmap
Phase 1 (Completed)
- Docker Homelab
- Forgejo Deployment
- K3s Installation
- GitOps Repository Creation
Phase 2 (Current)
- FluxCD Installation
- GitOps Bootstrap
- Longhorn Deployment
Phase 3
- Homepage Migration
- Linkding Migration
Phase 4
- Kavita Migration
- Forgejo Migration
Phase 5
- Grafana Migration
- Prometheus Migration
Phase 6
- Authentik Deployment
- Open WebUI Deployment
- LiteLLM Deployment
Backup Strategy
Planned:
- Git repository backups
- Application volume backups
- Longhorn snapshots
- Off-site backups
Version History
Version 1.1
Initial Homelab Documentation
Version 1.2
K3s Installation Milestone
Version 1.3
Forgejo GitOps Repository Established K3s Operational Documentation Baseline Created Ready for FluxCD Deployment
Current Status
Homelab State:
Operational
Kubernetes State:
Ready
GitOps State:
Repository Created
Awaiting FluxCD Integration
Next Milestone:
FluxCD Installation and Forgejo Integration