# boemeltrein/taloscluster architecture

> Architecture diagram of the GitHub repository boemeltrein/taloscluster, generated by GitDiagram from its file tree, README and a sample of source files (last updated 2026-11-22). It is an AI-made overview: check details against the source.

- Interactive diagram: https://gitdiagram.com/boemeltrein/taloscluster
- Repository: https://github.com/boemeltrein/taloscluster

## Overview

This repository is declarative configuration for a single-node Talos Kubernetes homelab. The principal workflow is maintaining cluster and workload configuration in Git, then having Flux continuously reconcile the declared state into Kubernetes; SOPS protects committed secrets for in-cluster decryption. The graph also preserves the documented workload, networking, observability, and shared-configuration areas. No source excerpts were supplied, so relationships beyond those explicitly described in the README are omitted or marked unverified.

Main entry points: [`kubernetes/apps`](https://github.com/boemeltrein/taloscluster/tree/main/kubernetes/apps) (Workload declarations), [`kubernetes/apps/observability`](https://github.com/boemeltrein/taloscluster/tree/main/kubernetes/apps/observability) (Observability services), [`kubernetes/flux-entry`](https://github.com/boemeltrein/taloscluster/tree/main/kubernetes/flux-entry) (Flux entry point), [`kubernetes/apps/networking`](https://github.com/boemeltrein/taloscluster/tree/main/kubernetes/apps/networking) (Networking services)

## Diagram (Mermaid)

```mermaid
flowchart TD

subgraph group_cluster["Cluster foundation"]
  node_talos["Talos configuration"]
  node_flux["Flux entry point"]
  node_kubernetes{{"Kubernetes cluster"}}
  node_repositories["Helm and OCI sources"]
end

subgraph group_workloads["Applications"]
  node_apps["Workload declarations"]
  node_media["Media services"]
  node_homeauto["Home automation"]
  node_gaming["Gaming services"]
  node_networking["Networking services"]
  node_security["Security services"]
end

subgraph group_operations["Operations"]
  node_observability["Observability services"]
  node_monitoring["Metrics and alerting"]
  node_status["Status and statistics"]
end

subgraph group_shared["Shared configuration"]
  node_secrets["Encrypted secrets"]
  node_components["Shared components"]
  node_clusterconfig["Cluster configuration"]
end

node_operator(("Cluster operator"))
node_git["Git repository"]
node_cloudflare{{"Cloudflare"}}
node_github{{"GitHub"}}

node_operator -->|"maintains config"| node_git
node_git -->|"provides desired state"| node_flux
node_flux -->|"reconciles continuously"| node_kubernetes
node_talos -->|"defines platform"| node_kubernetes
node_apps -->|"declares workloads"| node_kubernetes
node_repositories -.->|"provides sources"| node_kubernetes
node_secrets -->|"decrypted in cluster"| node_flux
node_apps -->|"groups services"| node_media
node_apps -->|"groups services"| node_homeauto
node_apps -->|"groups services"| node_gaming
node_apps -->|"groups services"| node_networking
node_apps -->|"groups services"| node_security
node_apps -->|"groups services"| node_observability
node_observability -->|"includes monitoring"| node_monitoring
node_observability -->|"includes status"| node_status
node_components -->|"provides shared configuration"| node_kubernetes
node_clusterconfig -->|"configures cluster"| node_kubernetes
node_github -->|"hosts source"| node_git
node_cloudflare -->|"supports DNS and tunnels"| node_networking

click node_talos "https://github.com/boemeltrein/taloscluster/tree/main/talos"
click node_flux "https://github.com/boemeltrein/taloscluster/tree/main/kubernetes/flux-entry"
click node_repositories "https://github.com/boemeltrein/taloscluster/tree/main/kubernetes/repositories"
click node_apps "https://github.com/boemeltrein/taloscluster/tree/main/kubernetes/apps"
click node_media "https://github.com/boemeltrein/taloscluster/tree/main/kubernetes/apps/media"
click node_homeauto "https://github.com/boemeltrein/taloscluster/tree/main/kubernetes/apps/home-automation"
click node_gaming "https://github.com/boemeltrein/taloscluster/tree/main/kubernetes/apps/gaming"
click node_networking "https://github.com/boemeltrein/taloscluster/tree/main/kubernetes/apps/networking"
click node_security "https://github.com/boemeltrein/taloscluster/tree/main/kubernetes/apps/security"
click node_observability "https://github.com/boemeltrein/taloscluster/tree/main/kubernetes/apps/observability"
click node_monitoring "https://github.com/boemeltrein/taloscluster/tree/main/kubernetes/apps/observability/kube-prometheus-stack/app"
click node_status "https://github.com/boemeltrein/taloscluster/tree/main/kubernetes/apps/observability/gatus"
click node_secrets "https://github.com/boemeltrein/taloscluster/tree/main/kubernetes"
click node_components "https://github.com/boemeltrein/taloscluster/tree/main/kubernetes/components"
click node_clusterconfig "https://github.com/boemeltrein/taloscluster/tree/main/kubernetes/config"

classDef toneNeutral fill:#f8fafc,stroke:#334155,stroke-width:1.5px,color:#0f172a
classDef toneBlue fill:#dbeafe,stroke:#2563eb,stroke-width:1.5px,color:#172554
classDef toneAmber fill:#fef3c7,stroke:#d97706,stroke-width:1.5px,color:#78350f
classDef toneMint fill:#dcfce7,stroke:#16a34a,stroke-width:1.5px,color:#14532d
classDef toneRose fill:#ffe4e6,stroke:#e11d48,stroke-width:1.5px,color:#881337
classDef toneIndigo fill:#e0e7ff,stroke:#4f46e5,stroke-width:1.5px,color:#312e81
classDef toneTeal fill:#ccfbf1,stroke:#0f766e,stroke-width:1.5px,color:#134e4a
class node_talos,node_flux,node_kubernetes,node_repositories toneBlue
class node_apps,node_media,node_homeauto,node_gaming,node_networking,node_security toneAmber
class node_observability,node_monitoring,node_status toneMint
class node_secrets,node_components,node_clusterconfig toneRose
class node_operator,node_git,node_cloudflare,node_github toneIndigo
```

## Components

### Cluster foundation

- [Talos configuration](https://github.com/boemeltrein/taloscluster/tree/main/talos): `talos`
- [Flux entry point](https://github.com/boemeltrein/taloscluster/tree/main/kubernetes/flux-entry): `kubernetes/flux-entry`
- **Kubernetes cluster**
- [Helm and OCI sources](https://github.com/boemeltrein/taloscluster/tree/main/kubernetes/repositories): `kubernetes/repositories`

### Applications

- [Workload declarations](https://github.com/boemeltrein/taloscluster/tree/main/kubernetes/apps): `kubernetes/apps`
- [Media services](https://github.com/boemeltrein/taloscluster/tree/main/kubernetes/apps/media): `kubernetes/apps/media`
- [Home automation](https://github.com/boemeltrein/taloscluster/tree/main/kubernetes/apps/home-automation): `kubernetes/apps/home-automation`
- [Gaming services](https://github.com/boemeltrein/taloscluster/tree/main/kubernetes/apps/gaming): `kubernetes/apps/gaming`
- [Networking services](https://github.com/boemeltrein/taloscluster/tree/main/kubernetes/apps/networking): `kubernetes/apps/networking`
- [Security services](https://github.com/boemeltrein/taloscluster/tree/main/kubernetes/apps/security): `kubernetes/apps/security`

### Operations

- [Observability services](https://github.com/boemeltrein/taloscluster/tree/main/kubernetes/apps/observability): `kubernetes/apps/observability`
- [Metrics and alerting](https://github.com/boemeltrein/taloscluster/tree/main/kubernetes/apps/observability/kube-prometheus-stack/app): `kubernetes/apps/observability/kube-prometheus-stack/app`
- [Status and statistics](https://github.com/boemeltrein/taloscluster/tree/main/kubernetes/apps/observability/gatus): `kubernetes/apps/observability/gatus`

### Shared configuration

- [Encrypted secrets](https://github.com/boemeltrein/taloscluster/tree/main/kubernetes): `kubernetes`
- [Shared components](https://github.com/boemeltrein/taloscluster/tree/main/kubernetes/components): `kubernetes/components`
- [Cluster configuration](https://github.com/boemeltrein/taloscluster/tree/main/kubernetes/config): `kubernetes/config`

### Other components

- **Cluster operator**
- **Git repository**
- **Cloudflare**
- **GitHub**

## Connections

- Cluster operator → Git repository: maintains config (evidence: `README.md`)
- Git repository → Flux entry point: provides desired state (evidence: `README.md`)
- Flux entry point → Kubernetes cluster: reconciles continuously (evidence: `README.md`)
- Talos configuration → Kubernetes cluster: defines platform (evidence: `README.md`)
- Workload declarations → Kubernetes cluster: declares workloads (evidence: `README.md`)
- Helm and OCI sources → Kubernetes cluster: provides sources
- Encrypted secrets → Flux entry point: decrypted in cluster (evidence: `README.md`)
- Workload declarations → Media services: groups services (evidence: `README.md`)
- Workload declarations → Home automation: groups services (evidence: `README.md`)
- Workload declarations → Gaming services: groups services (evidence: `README.md`)
- Workload declarations → Networking services: groups services (evidence: `README.md`)
- Workload declarations → Security services: groups services (evidence: `README.md`)
- Workload declarations → Observability services: groups services (evidence: `README.md`)
- Observability services → Metrics and alerting: includes monitoring (evidence: `README.md`)
- Observability services → Status and statistics: includes status (evidence: `README.md`)
- Shared components → Kubernetes cluster: provides shared configuration (evidence: `README.md`)
- Cluster configuration → Kubernetes cluster: configures cluster (evidence: `README.md`)
- GitHub → Git repository: hosts source (evidence: `README.md`)
- Cloudflare → Networking services: supports DNS and tunnels (evidence: `README.md`)
