# onedr0p/home-ops architecture

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

- Interactive diagram: https://gitdiagram.com/onedr0p/home-ops
- Repository: https://github.com/onedr0p/home-ops

## Overview

This is a GitOps-managed home infrastructure repository for a Talos Kubernetes cluster. The principal workflow is an operator committing desired state under kubernetes/, Flux discovering and applying Kustomizations, and Helm releases deploying applications and platform services. Those services provide networking, ingress, secrets, storage, backups, observability, and CI runners. Relationships are based on the README and file tree; no source excerpts were available, so application-internal calls are not inferred.

Main entry points: [`kubernetes/flux/cluster`](https://github.com/onedr0p/home-ops/tree/main/kubernetes/flux/cluster) (Kubernetes Cluster), [`kubernetes/apps/flux-system/flux-instance/app/helmrelease.yaml`](https://github.com/onedr0p/home-ops/blob/main/kubernetes/apps/flux-system/flux-instance/app/helmrelease.yaml) (Flux System), [`kubernetes/apps/network/cloudflare-tunnel/app/helmrelease.yaml`](https://github.com/onedr0p/home-ops/blob/main/kubernetes/apps/network/cloudflare-tunnel/app/helmrelease.yaml) (Cloudflare Tunnel), [`kubernetes/apps/rook-ceph/rook-ceph/cluster`](https://github.com/onedr0p/home-ops/tree/main/kubernetes/apps/rook-ceph/rook-ceph/cluster) (Rook Ceph Storage)

## Diagram (Mermaid)

```mermaid
flowchart TD

subgraph group_gitops["GitOps Control"]
  node_gitrepo["Desired State"]
  node_flux["Flux System<br/>[helmrelease.yaml]"]
  node_appks["App Kustomizations<br/>[kustomization.yaml]"]
  node_atuin["Atuin Release<br/>[helmrelease.yaml]"]
end

subgraph group_platform["Cluster Platform"]
  node_talos["Talos Nodes"]
  node_cluster["Kubernetes Cluster"]
  node_cilium["Cilium Networking<br/>[helmrelease.yaml]"]
  node_spegel["OCI Image Mirror<br/>[helmrelease.yaml]"]
  node_runners["Actions Runners<br/>[helmrelease.yaml]"]
end

subgraph group_network["Networking Security"]
  node_tunnel["Cloudflare Tunnel<br/>[helmrelease.yaml]"]
  node_dns["External DNS<br/>[helmrelease.yaml]"]
  node_certs["Certificate Manager<br/>[helmrelease.yaml]"]
  node_onepassword["1Password Connect<br/>[helmrelease.yaml]"]
  node_externalsecrets["External Secrets<br/>[helmrelease.yaml]"]
end

subgraph group_data["Storage Protection"]
  node_rook[("Rook Ceph Storage")]
  node_kopiur["Kopiur Backups<br/>[helmrelease.yaml]"]
end

subgraph group_observe["Observability Automation"]
  node_observability["Monitoring Stack"]
  node_kromgo["Status Badges"]
end

node_operator(("Home Operator"))
node_cloudflare{{"Cloudflare Edge"}}
node_github{{"GitHub"}}
node_clusterusers(("Cluster Users"))

node_operator -->|"commits state"| node_gitrepo
node_gitrepo -->|"watched by"| node_flux
node_flux -->|"applies"| node_appks
node_appks -->|"creates"| node_atuin
node_atuin -->|"depends on"| node_rook
node_talos -->|"provides nodes"| node_cluster
node_flux -->|"reconciles"| node_cluster
node_cluster -->|"runs networking"| node_cilium
node_cluster -->|"runs mirror"| node_spegel
node_github -.->|"dispatches jobs"| node_runners
node_cloudflare -.->|"secures ingress"| node_tunnel
node_tunnel -->|"routes traffic"| node_cluster
node_dns -.->|"syncs records"| node_cloudflare
node_certs -->|"issues certificates"| node_cluster
node_onepassword -->|"provides secrets"| node_externalsecrets
node_externalsecrets -->|"injects secrets"| node_cluster
node_rook -->|"provides volumes"| node_cluster
node_kopiur -->|"backs up data"| node_rook
node_observability -->|"collects metrics"| node_cluster
node_kromgo -->|"reads metrics"| node_observability
node_clusterusers -->|"accesses services"| node_tunnel

click node_gitrepo "https://github.com/onedr0p/home-ops/tree/main/kubernetes"
click node_flux "https://github.com/onedr0p/home-ops/blob/main/kubernetes/apps/flux-system/flux-instance/app/helmrelease.yaml"
click node_appks "https://github.com/onedr0p/home-ops/blob/main/kubernetes/apps/default/kustomization.yaml"
click node_atuin "https://github.com/onedr0p/home-ops/blob/main/kubernetes/apps/default/atuin/app/helmrelease.yaml"
click node_talos "https://github.com/onedr0p/home-ops/tree/main/talos/nodes"
click node_cluster "https://github.com/onedr0p/home-ops/tree/main/kubernetes/flux/cluster"
click node_cilium "https://github.com/onedr0p/home-ops/blob/main/kubernetes/apps/kube-system/cilium/app/helmrelease.yaml"
click node_spegel "https://github.com/onedr0p/home-ops/blob/main/kubernetes/apps/kube-system/spegel/app/helmrelease.yaml"
click node_runners "https://github.com/onedr0p/home-ops/blob/main/kubernetes/apps/actions-runner-system/actions-runner-controller/app/helmrelease.yaml"
click node_tunnel "https://github.com/onedr0p/home-ops/blob/main/kubernetes/apps/network/cloudflare-tunnel/app/helmrelease.yaml"
click node_dns "https://github.com/onedr0p/home-ops/blob/main/kubernetes/apps/network/cloudflare-dns/app/helmrelease.yaml"
click node_certs "https://github.com/onedr0p/home-ops/blob/main/kubernetes/apps/cert-manager/cert-manager/app/helmrelease.yaml"
click node_onepassword "https://github.com/onedr0p/home-ops/blob/main/kubernetes/apps/external-secrets/onepassword-connect/app/helmrelease.yaml"
click node_externalsecrets "https://github.com/onedr0p/home-ops/blob/main/kubernetes/apps/external-secrets/external-secrets/app/helmrelease.yaml"
click node_rook "https://github.com/onedr0p/home-ops/tree/main/kubernetes/apps/rook-ceph/rook-ceph/cluster"
click node_kopiur "https://github.com/onedr0p/home-ops/blob/main/kubernetes/apps/kopiur-system/kopiur/app/helmrelease.yaml"
click node_observability "https://github.com/onedr0p/home-ops/tree/main/kubernetes/apps/o11y/kube-prometheus-stack/app"
click node_kromgo "https://github.com/onedr0p/home-ops/tree/main/kubernetes/apps/o11y/kromgo/app"

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_gitrepo,node_flux,node_appks,node_atuin,node_clusterusers toneBlue
class node_talos,node_cluster,node_cilium,node_spegel,node_runners toneAmber
class node_tunnel,node_dns,node_certs,node_onepassword,node_externalsecrets toneMint
class node_rook,node_kopiur toneRose
class node_observability,node_kromgo,node_operator,node_cloudflare,node_github toneIndigo
```

## Components

### GitOps Control

- [Desired State](https://github.com/onedr0p/home-ops/tree/main/kubernetes): `kubernetes`
- [Flux System](https://github.com/onedr0p/home-ops/blob/main/kubernetes/apps/flux-system/flux-instance/app/helmrelease.yaml): `kubernetes/apps/flux-system/flux-instance/app/helmrelease.yaml`
- [App Kustomizations](https://github.com/onedr0p/home-ops/blob/main/kubernetes/apps/default/kustomization.yaml): `kubernetes/apps/default/kustomization.yaml`
- [Atuin Release](https://github.com/onedr0p/home-ops/blob/main/kubernetes/apps/default/atuin/app/helmrelease.yaml): `kubernetes/apps/default/atuin/app/helmrelease.yaml`

### Cluster Platform

- [Talos Nodes](https://github.com/onedr0p/home-ops/tree/main/talos/nodes): `talos/nodes`
- [Kubernetes Cluster](https://github.com/onedr0p/home-ops/tree/main/kubernetes/flux/cluster): `kubernetes/flux/cluster`
- [Cilium Networking](https://github.com/onedr0p/home-ops/blob/main/kubernetes/apps/kube-system/cilium/app/helmrelease.yaml): `kubernetes/apps/kube-system/cilium/app/helmrelease.yaml`
- [OCI Image Mirror](https://github.com/onedr0p/home-ops/blob/main/kubernetes/apps/kube-system/spegel/app/helmrelease.yaml): `kubernetes/apps/kube-system/spegel/app/helmrelease.yaml`
- [Actions Runners](https://github.com/onedr0p/home-ops/blob/main/kubernetes/apps/actions-runner-system/actions-runner-controller/app/helmrelease.yaml): `kubernetes/apps/actions-runner-system/actions-runner-controller/app/helmrelease.yaml`

### Networking Security

- [Cloudflare Tunnel](https://github.com/onedr0p/home-ops/blob/main/kubernetes/apps/network/cloudflare-tunnel/app/helmrelease.yaml): `kubernetes/apps/network/cloudflare-tunnel/app/helmrelease.yaml`
- [External DNS](https://github.com/onedr0p/home-ops/blob/main/kubernetes/apps/network/cloudflare-dns/app/helmrelease.yaml): `kubernetes/apps/network/cloudflare-dns/app/helmrelease.yaml`
- [Certificate Manager](https://github.com/onedr0p/home-ops/blob/main/kubernetes/apps/cert-manager/cert-manager/app/helmrelease.yaml): `kubernetes/apps/cert-manager/cert-manager/app/helmrelease.yaml`
- [1Password Connect](https://github.com/onedr0p/home-ops/blob/main/kubernetes/apps/external-secrets/onepassword-connect/app/helmrelease.yaml): `kubernetes/apps/external-secrets/onepassword-connect/app/helmrelease.yaml`
- [External Secrets](https://github.com/onedr0p/home-ops/blob/main/kubernetes/apps/external-secrets/external-secrets/app/helmrelease.yaml): `kubernetes/apps/external-secrets/external-secrets/app/helmrelease.yaml`

### Storage Protection

- [Rook Ceph Storage](https://github.com/onedr0p/home-ops/tree/main/kubernetes/apps/rook-ceph/rook-ceph/cluster): `kubernetes/apps/rook-ceph/rook-ceph/cluster`
- [Kopiur Backups](https://github.com/onedr0p/home-ops/blob/main/kubernetes/apps/kopiur-system/kopiur/app/helmrelease.yaml): `kubernetes/apps/kopiur-system/kopiur/app/helmrelease.yaml`

### Observability Automation

- [Monitoring Stack](https://github.com/onedr0p/home-ops/tree/main/kubernetes/apps/o11y/kube-prometheus-stack/app): `kubernetes/apps/o11y/kube-prometheus-stack/app`
- [Status Badges](https://github.com/onedr0p/home-ops/tree/main/kubernetes/apps/o11y/kromgo/app): `kubernetes/apps/o11y/kromgo/app`

### Other components

- **Home Operator**
- **Cloudflare Edge**
- **GitHub**
- **Cluster Users**

## Connections

- Home Operator → Desired State: commits state
- Desired State → Flux System: watched by
- Flux System → App Kustomizations: applies
- App Kustomizations → Atuin Release: creates
- Atuin Release → Rook Ceph Storage: depends on
- Talos Nodes → Kubernetes Cluster: provides nodes
- Flux System → Kubernetes Cluster: reconciles
- Kubernetes Cluster → Cilium Networking: runs networking
- Kubernetes Cluster → OCI Image Mirror: runs mirror
- GitHub → Actions Runners: dispatches jobs
- Cloudflare Edge → Cloudflare Tunnel: secures ingress
- Cloudflare Tunnel → Kubernetes Cluster: routes traffic
- External DNS → Cloudflare Edge: syncs records
- Certificate Manager → Kubernetes Cluster: issues certificates
- 1Password Connect → External Secrets: provides secrets
- External Secrets → Kubernetes Cluster: injects secrets
- Rook Ceph Storage → Kubernetes Cluster: provides volumes
- Kopiur Backups → Rook Ceph Storage: backs up data
- Monitoring Stack → Kubernetes Cluster: collects metrics
- Status Badges → Monitoring Stack: reads metrics
- Cluster Users → Cloudflare Tunnel: accesses services
