🏡 Homelab Ecosystem Overview

Welcome to the DeKeyrel Homelab Ecosystem, a modular, Redis-first architecture designed for declarative automation, secure secrets management, and real-time microservice orchestration. This site documents the core components, patterns, and roles that power the system—each built to be composable, transparent, and open-source.

🧭 Architectural Flow

flowchart TD
    A[Ansible Playbooks]
    V[Vault Server]
    K[MicroK8s Cluster]
    T[Vault Transit Engine]
    S[Encrypted Secrets in MicroK8s]
    M[Microservices]

    A --> V
    A --> K
    V --> K
    K --> T
    T --> S
    S --> M

🔍 Overview

High-level summary of the homelab architecture, guiding principles, and role-based structure.

🔐 Vault

Provisioning and configuring HashiCorp Vault via Ansible, including Kubernetes authentication and transit encryption.

⚙️ MicroK8s

Cluster setup using Ansible, plugin enablement, and Vault integration for secrets management.

🗝️ Secret Manager

Lifecycle of secrets: encrypted via Vault Transit, stored in MicroK8s, and consumed by microservices at runtime.

Repo Purpose
Ansible Core automation roles for provisioning and configuration
SecretManager Secrets lifecycle and templating logic
MicroServiceMatrix Collection of microservices
KVUpdater Redis-first state update service
APIServer SSE-providing API gateway for microservices
MatrixClient SSE-driven RGB LED Frontend display for real-time data
WebDisplay SSE-driven Web Frontend display for real-time data

🧠 Philosophy

This ecosystem is built on the belief that: