# dcollins50/dcollins-homelab architecture

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

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

## Overview

This repository documents a live, segmented Proxmox homelab rather than a software package. Its operational workflow is remote administration of clustered workloads over isolated VLANs, with endpoint and network telemetry monitored by the SOC and alerts handled through automation and incident management. The graph preserves the documented network, compute, PKI, services, lab, and SOC branches. No source excerpts were provided, so relationships are limited to statements in the README; paths identify the corresponding documentation areas.

Main entry points: [`docs/Infrastructure.md`](https://github.com/dcollins50/dcollins-homelab/blob/main/docs/Infrastructure.md) (Proxmox Cluster), [`docs/Hosts/wazuh-manager.md`](https://github.com/dcollins50/dcollins-homelab/blob/main/docs/Hosts/wazuh-manager.md) (Wazuh SIEM), [`docs/PKI.md`](https://github.com/dcollins50/dcollins-homelab/blob/main/docs/PKI.md) (Internal PKI), [`docs/Hosts/soc-stack-vm.md`](https://github.com/dcollins50/dcollins-homelab/blob/main/docs/Hosts/soc-stack-vm.md) (Elastic Stack)

## Diagram (Mermaid)

```mermaid
flowchart TD

subgraph group_network_compute["Network and Compute"]
  node_proxmox["Proxmox Cluster<br/>[Infrastructure.md]"]
  node_opnsense["OPNsense Firewall<br/>[opnsense.md]"]
  node_vlans["Segmented VLANs<br/>[Network.md]"]
  node_switch["Managed Switch"]
end

subgraph group_soc["Security Operations"]
  node_wazuh_agents["Wazuh Agents<br/>[SOC-Stack.md]"]
  node_opnsense_monitoring["Firewall Monitoring"]
  node_wazuh["Wazuh SIEM<br/>[wazuh-manager.md]"]
  node_elastic[("Elastic Stack<br/>[soc-stack-vm.md]")]
  node_shuffle["Shuffle SOAR<br/>[soar-host.md]"]
  node_iris["DFIR-IRIS<br/>[pve-iris.md]"]
end

subgraph group_trust_access["Trust and Remote Access"]
  node_remote_access["Remote Access<br/>[Tailscale.md]"]
  node_cloudflare_tunnel["Cloudflare Tunnels"]
  node_wireguard["WireGuard VPN"]
  node_pki["Internal PKI<br/>[PKI.md]"]
  node_authentik["Authentik IdP<br/>[authentik.md]"]
end

subgraph group_workloads["Services and Lab"]
  node_services["Hosted Services<br/>[services-host.md]"]
  node_security_lab["Security Lab<br/>[Security-Lab.md]"]
end

node_admin(("Administrator"))
node_alerts["Security Alerts"]

node_admin -->|"administers remotely"| node_remote_access
node_admin -->|"administers remotely"| node_cloudflare_tunnel
node_admin -->|"administers remotely"| node_wireguard
node_remote_access -.->|"accesses infrastructure"| node_proxmox
node_cloudflare_tunnel -->|"publishes access to"| node_authentik
node_wireguard -.->|"supports administration"| node_proxmox
node_pki -->|"issues service certificates"| node_services
node_pki -->|"issues service certificates"| node_elastic
node_pki -->|"issues service certificates"| node_wazuh
node_proxmox -->|"hosts workloads"| node_services
node_proxmox -->|"hosts workloads"| node_wazuh
node_proxmox -->|"hosts workloads"| node_elastic
node_opnsense -->|"enforces isolation"| node_vlans
node_switch -->|"tags traffic"| node_vlans
node_proxmox -->|"hosts lab systems"| node_security_lab
node_wazuh_agents -->|"send telemetry"| node_wazuh
node_opnsense_monitoring -->|"monitors agentlessly"| node_wazuh
node_wazuh -->|"connects over HTTPS"| node_elastic
node_wazuh -.->|"detects events"| node_alerts
node_alerts -.->|"automates response"| node_shuffle
node_shuffle -.->|"debounces ticket creation"| node_iris

click node_remote_access "https://github.com/dcollins50/dcollins-homelab/blob/main/docs/Tailscale.md"
click node_cloudflare_tunnel "https://github.com/dcollins50/dcollins-homelab/blob/main/docs/Runbooks/cloudflare/cloudflare-tunnel-publish.md"
click node_wireguard "https://github.com/dcollins50/dcollins-homelab/blob/main/docs/Projects/vps-wireguard-tunnel.md"
click node_pki "https://github.com/dcollins50/dcollins-homelab/blob/main/docs/PKI.md"
click node_authentik "https://github.com/dcollins50/dcollins-homelab/blob/main/docs/Hosts/authentik.md"
click node_proxmox "https://github.com/dcollins50/dcollins-homelab/blob/main/docs/Infrastructure.md"
click node_opnsense "https://github.com/dcollins50/dcollins-homelab/blob/main/docs/Hosts/opnsense.md"
click node_vlans "https://github.com/dcollins50/dcollins-homelab/blob/main/docs/Network.md"
click node_switch "https://github.com/dcollins50/dcollins-homelab/blob/main/docs/Hosts/switch-tl-sg108e.md"
click node_services "https://github.com/dcollins50/dcollins-homelab/blob/main/docs/Hosts/services-host.md"
click node_security_lab "https://github.com/dcollins50/dcollins-homelab/blob/main/docs/Security-Lab.md"
click node_wazuh_agents "https://github.com/dcollins50/dcollins-homelab/blob/main/docs/SOC-Stack.md"
click node_opnsense_monitoring "https://github.com/dcollins50/dcollins-homelab/blob/main/docs/Runbooks/opnsense/opnsense-agentless-ssh-monitoring-setup.md"
click node_wazuh "https://github.com/dcollins50/dcollins-homelab/blob/main/docs/Hosts/wazuh-manager.md"
click node_elastic "https://github.com/dcollins50/dcollins-homelab/blob/main/docs/Hosts/soc-stack-vm.md"
click node_shuffle "https://github.com/dcollins50/dcollins-homelab/blob/main/docs/Hosts/soar-host.md"
click node_iris "https://github.com/dcollins50/dcollins-homelab/blob/main/docs/Hosts/pve-iris.md"

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,node_opnsense,node_vlans,node_switch toneBlue
class node_wazuh_agents,node_opnsense_monitoring,node_wazuh,node_elastic,node_shuffle,node_iris toneAmber
class node_remote_access,node_cloudflare_tunnel,node_wireguard,node_pki,node_authentik toneMint
class node_services,node_security_lab toneRose
class node_admin,node_alerts toneIndigo
```

## Components

### Network and Compute

- [Proxmox Cluster](https://github.com/dcollins50/dcollins-homelab/blob/main/docs/Infrastructure.md): `docs/Infrastructure.md`
- [OPNsense Firewall](https://github.com/dcollins50/dcollins-homelab/blob/main/docs/Hosts/opnsense.md): `docs/Hosts/opnsense.md`
- [Segmented VLANs](https://github.com/dcollins50/dcollins-homelab/blob/main/docs/Network.md): `docs/Network.md`
- [Managed Switch](https://github.com/dcollins50/dcollins-homelab/blob/main/docs/Hosts/switch-tl-sg108e.md): `docs/Hosts/switch-tl-sg108e.md`

### Security Operations

- [Wazuh Agents](https://github.com/dcollins50/dcollins-homelab/blob/main/docs/SOC-Stack.md): `docs/SOC-Stack.md`
- [Firewall Monitoring](https://github.com/dcollins50/dcollins-homelab/blob/main/docs/Runbooks/opnsense/opnsense-agentless-ssh-monitoring-setup.md): `docs/Runbooks/opnsense/opnsense-agentless-ssh-monitoring-setup.md`
- [Wazuh SIEM](https://github.com/dcollins50/dcollins-homelab/blob/main/docs/Hosts/wazuh-manager.md): `docs/Hosts/wazuh-manager.md`
- [Elastic Stack](https://github.com/dcollins50/dcollins-homelab/blob/main/docs/Hosts/soc-stack-vm.md): `docs/Hosts/soc-stack-vm.md`
- [Shuffle SOAR](https://github.com/dcollins50/dcollins-homelab/blob/main/docs/Hosts/soar-host.md): `docs/Hosts/soar-host.md`
- [DFIR-IRIS](https://github.com/dcollins50/dcollins-homelab/blob/main/docs/Hosts/pve-iris.md): `docs/Hosts/pve-iris.md`

### Trust and Remote Access

- [Remote Access](https://github.com/dcollins50/dcollins-homelab/blob/main/docs/Tailscale.md): `docs/Tailscale.md`
- [Cloudflare Tunnels](https://github.com/dcollins50/dcollins-homelab/blob/main/docs/Runbooks/cloudflare/cloudflare-tunnel-publish.md): `docs/Runbooks/cloudflare/cloudflare-tunnel-publish.md`
- [WireGuard VPN](https://github.com/dcollins50/dcollins-homelab/blob/main/docs/Projects/vps-wireguard-tunnel.md): `docs/Projects/vps-wireguard-tunnel.md`
- [Internal PKI](https://github.com/dcollins50/dcollins-homelab/blob/main/docs/PKI.md): `docs/PKI.md`
- [Authentik IdP](https://github.com/dcollins50/dcollins-homelab/blob/main/docs/Hosts/authentik.md): `docs/Hosts/authentik.md`

### Services and Lab

- [Hosted Services](https://github.com/dcollins50/dcollins-homelab/blob/main/docs/Hosts/services-host.md): `docs/Hosts/services-host.md`
- [Security Lab](https://github.com/dcollins50/dcollins-homelab/blob/main/docs/Security-Lab.md): `docs/Security-Lab.md`

### Other components

- **Administrator**
- **Security Alerts**

## Connections

- Administrator → Remote Access: administers remotely (evidence: `README.md`)
- Administrator → Cloudflare Tunnels: administers remotely (evidence: `README.md`)
- Administrator → WireGuard VPN: administers remotely (evidence: `README.md`)
- Remote Access → Proxmox Cluster: accesses infrastructure
- Cloudflare Tunnels → Authentik IdP: publishes access to (evidence: `README.md`)
- WireGuard VPN → Proxmox Cluster: supports administration
- Internal PKI → Hosted Services: issues service certificates (evidence: `README.md`)
- Internal PKI → Elastic Stack: issues service certificates (evidence: `README.md`)
- Internal PKI → Wazuh SIEM: issues service certificates (evidence: `README.md`)
- Proxmox Cluster → Hosted Services: hosts workloads (evidence: `README.md`)
- Proxmox Cluster → Wazuh SIEM: hosts workloads (evidence: `README.md`)
- Proxmox Cluster → Elastic Stack: hosts workloads (evidence: `README.md`)
- OPNsense Firewall → Segmented VLANs: enforces isolation (evidence: `README.md`)
- Managed Switch → Segmented VLANs: tags traffic (evidence: `README.md`)
- Proxmox Cluster → Security Lab: hosts lab systems (evidence: `README.md`)
- Wazuh Agents → Wazuh SIEM: send telemetry (evidence: `README.md`)
- Firewall Monitoring → Wazuh SIEM: monitors agentlessly (evidence: `README.md`)
- Wazuh SIEM → Elastic Stack: connects over HTTPS (evidence: `README.md`)
- Wazuh SIEM → Security Alerts: detects events
- Security Alerts → Shuffle SOAR: automates response
- Shuffle SOAR → DFIR-IRIS: debounces ticket creation
