kenpat/kitestacks-homelab
1
0
Fork 0
Code Issues Pull requests Projects Releases Packages Wiki Activity Actions 1
kitestacks-homelab/docs/KiteStacks-Homelab-Documentation-v1.3.md

3.6 KiB
Raw Blame History

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:

T14s

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:

T14s 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
│   └── T14s
├── 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