# b-a-l-a-z-s/talos architecture

> Architecture diagram of the GitHub repository b-a-l-a-z-s/talos, 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/b-a-l-a-z-s/talos
- Repository: https://github.com/b-a-l-a-z-s/talos

## Overview

This repository declares and operates a personal Talos-based Kubernetes homelab, rather than implementing a standalone application. Its central workflow is Git-defined cluster configuration continuously reconciled by Flux into Kubernetes workloads; users reach home, media, and other services through the cluster’s internal or public networking. The graph also preserves the documented Talos/Proxmox foundation, storage and backups, security, and observability. Workload directories are represented at subsystem level because their individual configurations were not sampled; relationships reflect README statements, not inspection of those files.

Main entry points: [`clusters/main/kubernetes/networking`](https://github.com/b-a-l-a-z-s/talos/tree/main/clusters/main/kubernetes/networking) (Ingress and CNI), [`clusters/main/kubernetes`](https://github.com/b-a-l-a-z-s/talos/tree/main/clusters/main/kubernetes) (Kubernetes cluster config), [`clusters/main`](https://github.com/b-a-l-a-z-s/talos/tree/main/clusters/main) (Git configuration), [`clusters/main/kubernetes/flux-system`](https://github.com/b-a-l-a-z-s/talos/tree/main/clusters/main/kubernetes/flux-system) (Flux reconciliation)

## Diagram (Mermaid)

```mermaid
flowchart TD

subgraph group_platform["Cluster platform"]
  node_git_config["Git configuration"]
  node_flux["Flux reconciliation"]
  node_talos["Talos node config"]
  node_kubernetes["Kubernetes cluster config"]
end

subgraph group_workloads["Applications"]
  node_home_apps["Home services"]
  node_media_apps["Media services"]
  node_downloaders["Download services"]
  node_osint_apps["OSINT tools"]
  node_external_apps["External services"]
end

subgraph group_network_security["Networking security"]
  node_networking["Ingress and CNI"]
  node_cloudflare["Cloudflare tunnel"]
  node_security["Cluster security"]
end

subgraph group_operations["Storage observability"]
  node_storage[("Persistent storage")]
  node_backup["Backup configuration"]
  node_observability["Metrics logs alerts"]
end

node_operator(("Cluster operator"))
node_proxmox["Proxmox host"]
node_users(("LAN and internet users"))
node_truenas[("TrueNAS storage VM")]

node_operator -->|"updates config"| node_git_config
node_git_config -->|"reconciled by"| node_flux
node_flux -->|"reconciles config"| node_kubernetes
node_proxmox -->|"hosts VM"| node_talos
node_talos -->|"runs cluster"| node_kubernetes
node_users -->|"accesses services"| node_networking
node_cloudflare -->|"tunnels to ingress"| node_networking
node_networking -->|"routes requests"| node_home_apps
node_networking -.->|"routes requests"| node_media_apps
node_networking -.->|"routes requests"| node_downloaders
node_networking -.->|"routes requests"| node_external_apps
node_security -->|"protects public ingress"| node_networking
node_truenas -->|"provides network storage"| node_storage
node_storage -.->|"supports recovery"| node_backup
node_observability -->|"monitors cluster"| node_kubernetes

click node_git_config "https://github.com/b-a-l-a-z-s/talos/tree/main/clusters/main"
click node_flux "https://github.com/b-a-l-a-z-s/talos/tree/main/clusters/main/kubernetes/flux-system"
click node_talos "https://github.com/b-a-l-a-z-s/talos/tree/main/clusters/main/talos"
click node_kubernetes "https://github.com/b-a-l-a-z-s/talos/tree/main/clusters/main/kubernetes"
click node_home_apps "https://github.com/b-a-l-a-z-s/talos/tree/main/clusters/main/kubernetes/apps/home"
click node_media_apps "https://github.com/b-a-l-a-z-s/talos/tree/main/clusters/main/kubernetes/apps/media"
click node_downloaders "https://github.com/b-a-l-a-z-s/talos/tree/main/clusters/main/kubernetes/apps/downloaders"
click node_osint_apps "https://github.com/b-a-l-a-z-s/talos/tree/main/clusters/main/kubernetes/apps/osint"
click node_external_apps "https://github.com/b-a-l-a-z-s/talos/tree/main/clusters/main/kubernetes/apps/external"
click node_networking "https://github.com/b-a-l-a-z-s/talos/tree/main/clusters/main/kubernetes/networking"
click node_cloudflare "https://github.com/b-a-l-a-z-s/talos/tree/main/clusters/main/kubernetes/apps/security/cloudflared"
click node_security "https://github.com/b-a-l-a-z-s/talos/tree/main/clusters/main/kubernetes/apps/security"
click node_storage "https://github.com/b-a-l-a-z-s/talos/tree/main/clusters/main/kubernetes/system"
click node_backup "https://github.com/b-a-l-a-z-s/talos/tree/main/clusters/main/components/backup"
click node_observability "https://github.com/b-a-l-a-z-s/talos/tree/main/clusters/main/kubernetes/observability"

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_git_config,node_flux,node_talos,node_kubernetes,node_users toneBlue
class node_home_apps,node_media_apps,node_downloaders,node_osint_apps,node_external_apps,node_truenas toneAmber
class node_networking,node_cloudflare,node_security toneMint
class node_storage,node_backup,node_observability toneRose
class node_operator,node_proxmox toneIndigo
```

## Components

### Cluster platform

- [Git configuration](https://github.com/b-a-l-a-z-s/talos/tree/main/clusters/main): `clusters/main`
- [Flux reconciliation](https://github.com/b-a-l-a-z-s/talos/tree/main/clusters/main/kubernetes/flux-system): `clusters/main/kubernetes/flux-system`
- [Talos node config](https://github.com/b-a-l-a-z-s/talos/tree/main/clusters/main/talos): `clusters/main/talos`
- [Kubernetes cluster config](https://github.com/b-a-l-a-z-s/talos/tree/main/clusters/main/kubernetes): `clusters/main/kubernetes`

### Applications

- [Home services](https://github.com/b-a-l-a-z-s/talos/tree/main/clusters/main/kubernetes/apps/home): `clusters/main/kubernetes/apps/home`
- [Media services](https://github.com/b-a-l-a-z-s/talos/tree/main/clusters/main/kubernetes/apps/media): `clusters/main/kubernetes/apps/media`
- [Download services](https://github.com/b-a-l-a-z-s/talos/tree/main/clusters/main/kubernetes/apps/downloaders): `clusters/main/kubernetes/apps/downloaders`
- [OSINT tools](https://github.com/b-a-l-a-z-s/talos/tree/main/clusters/main/kubernetes/apps/osint): `clusters/main/kubernetes/apps/osint`
- [External services](https://github.com/b-a-l-a-z-s/talos/tree/main/clusters/main/kubernetes/apps/external): `clusters/main/kubernetes/apps/external`

### Networking security

- [Ingress and CNI](https://github.com/b-a-l-a-z-s/talos/tree/main/clusters/main/kubernetes/networking): `clusters/main/kubernetes/networking`
- [Cloudflare tunnel](https://github.com/b-a-l-a-z-s/talos/tree/main/clusters/main/kubernetes/apps/security/cloudflared): `clusters/main/kubernetes/apps/security/cloudflared`
- [Cluster security](https://github.com/b-a-l-a-z-s/talos/tree/main/clusters/main/kubernetes/apps/security): `clusters/main/kubernetes/apps/security`

### Storage observability

- [Persistent storage](https://github.com/b-a-l-a-z-s/talos/tree/main/clusters/main/kubernetes/system): `clusters/main/kubernetes/system`
- [Backup configuration](https://github.com/b-a-l-a-z-s/talos/tree/main/clusters/main/components/backup): `clusters/main/components/backup`
- [Metrics logs alerts](https://github.com/b-a-l-a-z-s/talos/tree/main/clusters/main/kubernetes/observability): `clusters/main/kubernetes/observability`

### Other components

- **Cluster operator**
- **Proxmox host**
- **LAN and internet users**
- **TrueNAS storage VM**

## Connections

- Cluster operator → Git configuration: updates config (evidence: `README.md`)
- Git configuration → Flux reconciliation: reconciled by (evidence: `README.md`)
- Flux reconciliation → Kubernetes cluster config: reconciles config (evidence: `README.md`)
- Proxmox host → Talos node config: hosts VM (evidence: `README.md`)
- Talos node config → Kubernetes cluster config: runs cluster (evidence: `README.md`)
- LAN and internet users → Ingress and CNI: accesses services (evidence: `README.md`)
- Cloudflare tunnel → Ingress and CNI: tunnels to ingress (evidence: `README.md`)
- Ingress and CNI → Home services: routes requests (evidence: `README.md`)
- Ingress and CNI → Media services: routes requests
- Ingress and CNI → Download services: routes requests
- Ingress and CNI → External services: routes requests
- Cluster security → Ingress and CNI: protects public ingress (evidence: `README.md`)
- TrueNAS storage VM → Persistent storage: provides network storage (evidence: `README.md`)
- Persistent storage → Backup configuration: supports recovery
- Metrics logs alerts → Kubernetes cluster config: monitors cluster (evidence: `README.md`)
