Add Version 1.3 homelab documentation

docs/KiteStacks-Homelab-Documentation-v1.3.md

@@ -0,0 +1,339 @@
+# 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:
+
+```text
+assassin
+```
+
+Role:
+
+```text
+Primary Homelab Server
+Kubernetes Control Plane
+Docker Host
+GitOps Management Node
+```
+
+Operating System:
+
+```text
+Debian 13
+```
+
+---
+
+# Kubernetes
+
+## Distribution
+
+```text
+K3s
+```
+
+Version:
+
+```text
+v1.35.5+k3s1
+```
+
+Status:
+
+```text
+Ready
+```
+
+Verification:
+
+```bash
+kubectl get nodes
+```
+
+Expected Result:
+
+```text
+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
+
+```text
+Forgejo
+```
+
+Repository:
+
+```text
+https://gitforge.kitestacks.com/kenpat/kitestacks-homelab.git
+```
+
+Visibility:
+
+```text
+Private
+```
+
+Purpose:
+
+* Infrastructure as Code
+* Kubernetes manifests
+* Documentation
+* Application deployment
+* Disaster recovery
+
+---
+
+## Repository Structure
+
+```text
+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
+
+```text
+/home/kenpat/library/books
+```
+
+## Current Status
+
+Running in Docker.
+
+Future migration planned to Kubernetes.
+
+---
+
+# Cloudflare
+
+## Domain
+
+```text
+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:
+
+```text
+Operational
+```
+
+Kubernetes State:
+
+```text
+Ready
+```
+
+GitOps State:
+
+```text
+Repository Created
+Awaiting FluxCD Integration
+```
+
+Next Milestone:
+
+```text
+FluxCD Installation and Forgejo Integration
+```