# the-homelab-00/homelab architecture

> Architecture diagram of the GitHub repository the-homelab-00/homelab, generated by GitDiagram from its file tree, README and a sample of source files (last updated 2025-01-06). It is an AI-made overview: check details against the source.

- Interactive diagram: https://gitdiagram.com/the-homelab-00/homelab
- Repository: https://github.com/the-homelab-00/homelab

## Overview

##### High-Level Architecture Overview

The system should be represented as a multi-layer architecture with the following main components:

**┌─ Infrastructure Layer ─────────────────────┐**
- Talos Linux Nodes                         │
- (Control Plane + Worker Nodes)            │
- ┘
- ↑
**┌─ Core Services Layer ──────────────────────┐**
- Flux CD                                 │
- Cilium (CNI)                           │
- CoreDNS                                │
- Cert-Manager                           │
- ┘
- ↑
**┌─ Storage Layer ───────────────────────────┐**
- OpenEBS                                │
- Rook-Ceph (Optional)                   │
- ┘
- ↑
**┌─ Network Layer ───────────────────────────┐**
- Ingress NGINX                          │
- External DNS                           │
- Cloudflare Tunnel                      │
- ┘
- ↑
**┌─ Application Layer ─────────────────────────┐**
- Default Namespace Apps                   │
- Monitoring Stack                        │
- Database Services                       │
- ┘

##### Deployment Flow

A separate section showing the deployment flow:
**GitHub Repo → Flux → Kustomize/Helm → Kubernetes Resources**

## Diagram (Mermaid)

```mermaid
graph TB
    %% Styles
    classDef infrastructure fill:#E6E6E6,stroke:#333
    classDef core fill:#B3D9FF,stroke:#333
    classDef storage fill:#B3FFB3,stroke:#333
    classDef network fill:#FFD9B3,stroke:#333
    classDef application fill:#E6B3FF,stroke:#333
    classDef security fill:#FFB3B3,stroke:#333

    %% Infrastructure Layer
    subgraph Infrastructure
        TalosNodes["Talos Linux Nodes"]
        TalosConfig["Talos Configuration"]
    end
    class TalosNodes,TalosConfig infrastructure

    %% Core Services Layer
    subgraph CoreServices
        FluxCD["Flux CD"]
        Cilium["Cilium CNI"]
        CoreDNS["CoreDNS"]
        CertManager["Cert-Manager"]
    end
    class FluxCD,Cilium,CoreDNS,CertManager core

    %% Storage Layer
    subgraph Storage
        OpenEBS["OpenEBS"]
        RookCeph["Rook-Ceph"]
    end
    class OpenEBS,RookCeph storage

    %% Network Layer
    subgraph Network
        IngressNginx["Ingress NGINX"]
        ExternalDNS["External DNS"]
        CloudflareTunnel["Cloudflare Tunnel"]
    end
    class IngressNginx,ExternalDNS,CloudflareTunnel network

    %% Application Layer
    subgraph Applications
        DefaultApps["Default Apps"]
        MonitoringStack["Monitoring Stack"]
        DatabaseServices["Database Services"]
    end
    class DefaultApps,MonitoringStack,DatabaseServices application

    %% Security Components
    subgraph Security
        ExternalSecrets["External Secrets"]
        CertManagerIssuers["Cert Manager Issuers"]
    end
    class ExternalSecrets,CertManagerIssuers security

    %% Relationships
    Infrastructure --> CoreServices
    CoreServices --> Storage
    CoreServices --> Network
    Storage --> Applications
    Network --> Applications
    Security --> Applications

    %% Click Events
    click TalosNodes "https://github.com/the-homelab-00/homelab/tree/main/kubernetes/bootstrap/talos/"
    click TalosConfig "https://github.com/the-homelab-00/homelab/blob/main/kubernetes/bootstrap/talos/talconfig.yaml"
    click FluxCD "https://github.com/the-homelab-00/homelab/tree/main/kubernetes/apps/flux-system/"
    click Cilium "https://github.com/the-homelab-00/homelab/tree/main/kubernetes/apps/kube-system/cilium/"
    click CoreDNS "https://github.com/the-homelab-00/homelab/tree/main/kubernetes/apps/kube-system/coredns/"
    click CertManager "https://github.com/the-homelab-00/homelab/tree/main/kubernetes/apps/cert-manager/cert-manager/"
    click OpenEBS "https://github.com/the-homelab-00/homelab/tree/main/kubernetes/apps/openebs-system/openebs/"
    click RookCeph "https://github.com/the-homelab-00/homelab/tree/main/kubernetes/apps/rook-ceph/rook-ceph/"
    click IngressNginx "https://github.com/the-homelab-00/homelab/tree/main/kubernetes/apps/network/ingress-nginx/"
    click ExternalDNS "https://github.com/the-homelab-00/homelab/tree/main/kubernetes/apps/network/external-dns/"
    click CloudflareTunnel "https://github.com/the-homelab-00/homelab/tree/main/kubernetes/apps/network/cloudflared/"
    click MonitoringStack "https://github.com/the-homelab-00/homelab/tree/main/kubernetes/apps/observability/"
    click DatabaseServices "https://github.com/the-homelab-00/homelab/tree/main/kubernetes/apps/database/"
    click DefaultApps "https://github.com/the-homelab-00/homelab/tree/main/kubernetes/apps/default/"
    click ExternalSecrets "https://github.com/the-homelab-00/homelab/tree/main/kubernetes/apps/external-secrets/"
    click CertManagerIssuers "https://github.com/the-homelab-00/homelab/tree/main/kubernetes/apps/cert-manager/cert-manager/issuers/"
```
