# zahaanmahajan/homelab architecture

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

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

## Overview

This repository describes and configures a self-hosted Kubernetes homelab: Proxmox hosts provide VMs, Talos runs on the nodes, and Kubernetes hosts infrastructure services and applications. Its main operational path is virtualized infrastructure to cluster, then GitOps-managed platform and workload configuration; the labs provide a separate Kubernetes learning track. The README excerpt documents the infrastructure and network relationships, but no source excerpts were provided. Links inferred from the manifest layout are therefore dashed and unverified.

Main entry points: [`kubernetes/argocd`](https://github.com/zahaanmahajan/homelab/tree/main/kubernetes/argocd) (Argo CD), [`kubernetes/applications`](https://github.com/zahaanmahajan/homelab/tree/main/kubernetes/applications) (App Charts), [`kubernetes`](https://github.com/zahaanmahajan/homelab/tree/main/kubernetes) (Cluster Setup), [`talos`](https://github.com/zahaanmahajan/homelab/tree/main/talos) (Talos Nodes)

## Diagram (Mermaid)

```mermaid
flowchart TD

subgraph group_infra["Virtualized Infrastructure"]
  node_proxmox["Proxmox VMs"]
end

subgraph group_cluster["Cluster Configuration"]
  node_talos["Talos Nodes"]
  node_clusterconfig["Cluster Setup"]
  node_networking["Networking"]
  node_storage["NFS Storage"]
end

subgraph group_platform["Platform Services"]
  node_argocd["Argo CD"]
  node_homepage["Homepage"]
  node_monitoring["Monitoring"]
end

subgraph group_workloads["Applications"]
  node_apps["App Charts"]
  node_linkding["Linkding"]
  node_nextcloud["Nextcloud"]
  node_portfolio["Portfolio"]
end

subgraph group_learning["Kubernetes Learning"]
  node_labs["Kubernetes Labs"]
end

node_operator(("Operator"))

node_proxmox -->|"hosts VMs"| node_talos
node_talos -->|"runs Kubernetes"| node_clusterconfig
node_clusterconfig -.->|"configures networking"| node_networking
node_clusterconfig -.->|"configures storage"| node_storage
node_operator -.->|"manages GitOps"| node_argocd
node_argocd -.->|"deploys charts"| node_apps
node_argocd -.->|"deploys service"| node_homepage
node_argocd -.->|"deploys service"| node_monitoring
node_apps -.->|"includes chart"| node_linkding
node_apps -.->|"includes chart"| node_nextcloud
node_apps -.->|"includes chart"| node_portfolio
node_operator -.->|"practices Kubernetes"| node_labs

click node_proxmox "https://github.com/zahaanmahajan/homelab/tree/main/proxmox"
click node_talos "https://github.com/zahaanmahajan/homelab/tree/main/talos"
click node_clusterconfig "https://github.com/zahaanmahajan/homelab/tree/main/kubernetes"
click node_networking "https://github.com/zahaanmahajan/homelab/tree/main/kubernetes/infrastructure/networking"
click node_storage "https://github.com/zahaanmahajan/homelab/tree/main/kubernetes/infrastructure/storage/nfs"
click node_argocd "https://github.com/zahaanmahajan/homelab/tree/main/kubernetes/argocd"
click node_homepage "https://github.com/zahaanmahajan/homelab/tree/main/kubernetes/platform/homepage"
click node_monitoring "https://github.com/zahaanmahajan/homelab/tree/main/kubernetes/platform/monitoring"
click node_apps "https://github.com/zahaanmahajan/homelab/tree/main/kubernetes/applications"
click node_linkding "https://github.com/zahaanmahajan/homelab/tree/main/kubernetes/applications/linkding"
click node_nextcloud "https://github.com/zahaanmahajan/homelab/tree/main/kubernetes/applications/nextcloud"
click node_portfolio "https://github.com/zahaanmahajan/homelab/tree/main/kubernetes/applications/portfolio"
click node_labs "https://github.com/zahaanmahajan/homelab/tree/main/labs"

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_proxmox toneBlue
class node_talos,node_clusterconfig,node_networking,node_storage toneAmber
class node_argocd,node_homepage,node_monitoring toneMint
class node_apps,node_linkding,node_nextcloud,node_portfolio toneRose
class node_labs,node_operator toneIndigo
```

## Components

### Virtualized Infrastructure

- [Proxmox VMs](https://github.com/zahaanmahajan/homelab/tree/main/proxmox): `proxmox`

### Cluster Configuration

- [Talos Nodes](https://github.com/zahaanmahajan/homelab/tree/main/talos): `talos`
- [Cluster Setup](https://github.com/zahaanmahajan/homelab/tree/main/kubernetes): `kubernetes`
- [Networking](https://github.com/zahaanmahajan/homelab/tree/main/kubernetes/infrastructure/networking): `kubernetes/infrastructure/networking`
- [NFS Storage](https://github.com/zahaanmahajan/homelab/tree/main/kubernetes/infrastructure/storage/nfs): `kubernetes/infrastructure/storage/nfs`

### Platform Services

- [Argo CD](https://github.com/zahaanmahajan/homelab/tree/main/kubernetes/argocd): `kubernetes/argocd`
- [Homepage](https://github.com/zahaanmahajan/homelab/tree/main/kubernetes/platform/homepage): `kubernetes/platform/homepage`
- [Monitoring](https://github.com/zahaanmahajan/homelab/tree/main/kubernetes/platform/monitoring): `kubernetes/platform/monitoring`

### Applications

- [App Charts](https://github.com/zahaanmahajan/homelab/tree/main/kubernetes/applications): `kubernetes/applications`
- [Linkding](https://github.com/zahaanmahajan/homelab/tree/main/kubernetes/applications/linkding): `kubernetes/applications/linkding`
- [Nextcloud](https://github.com/zahaanmahajan/homelab/tree/main/kubernetes/applications/nextcloud): `kubernetes/applications/nextcloud`
- [Portfolio](https://github.com/zahaanmahajan/homelab/tree/main/kubernetes/applications/portfolio): `kubernetes/applications/portfolio`

### Kubernetes Learning

- [Kubernetes Labs](https://github.com/zahaanmahajan/homelab/tree/main/labs): `labs`

### Other components

- **Operator**

## Connections

- Proxmox VMs → Talos Nodes: hosts VMs (evidence: `README.md`)
- Talos Nodes → Cluster Setup: runs Kubernetes (evidence: `README.md`)
- Cluster Setup → Networking: configures networking
- Cluster Setup → NFS Storage: configures storage
- Operator → Argo CD: manages GitOps
- Argo CD → App Charts: deploys charts
- Argo CD → Homepage: deploys service
- Argo CD → Monitoring: deploys service
- App Charts → Linkding: includes chart
- App Charts → Nextcloud: includes chart
- App Charts → Portfolio: includes chart
- Operator → Kubernetes Labs: practices Kubernetes
