# jmpromm/enterprise-home-lab architecture

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

- Interactive diagram: https://gitdiagram.com/jmpromm/enterprise-home-lab
- Repository: https://github.com/jmpromm/enterprise-home-lab

## Overview

This repository documents an isolated enterprise-style home lab, not an application runtime. The main administration workflow is a management workstation accessing the Proxmox host to run Ubuntu and Windows Server VMs; Ubuntu provides internal DNS and SSH, while Windows uses that DNS and is prepared for future Active Directory. The graph also preserves the documented offline package-transfer, isolation, and planned infrastructure-management branches. Relationships are based on README statements; implementation details in the topology document and infrastructure configurations were not sampled.

Main entry points: [`README.md`](https://github.com/jmpromm/enterprise-home-lab/blob/main/README.md) (Management Workstation)

## Diagram (Mermaid)

```mermaid
flowchart TD

subgraph group_management["Administration"]
  node_admin(("Management Workstation<br/>[README.md]"))
  node_wsl["WSL Package Staging<br/>[README.md]"]
end

subgraph group_virtualization["Virtualization"]
  node_proxmox["Proxmox Host<br/>[README.md]"]
end

subgraph group_network["Network Services"]
  node_router["Lab Router<br/>[README.md]"]
  node_network{{"Isolated Lab Network<br/>[README.md]"}}
  node_dns["BIND9 DNS<br/>[README.md]"]
end

subgraph group_servers["Server Workloads"]
  node_ubuntu["Ubuntu Server VM<br/>[README.md]"]
  node_ssh["OpenSSH<br/>[README.md]"]
  node_windows["Windows Server VM<br/>[README.md]"]
end

subgraph group_planned["Planned Capabilities"]
  node_ad["Active Directory<br/>[README.md]"]
  node_monitoring["Monitoring and Logging<br/>[README.md]"]
  node_backup["Backup and Recovery<br/>[README.md]"]
  node_automation["Automation<br/>[README.md]"]
  node_security["Security and Testing<br/>[README.md]"]
end

node_internet(("Internet"))

node_admin -->|"administers"| node_proxmox
node_admin -->|"remote administration"| node_ubuntu
node_admin -->|"manages and tests"| node_windows
node_admin -->|"stages packages"| node_wsl
node_wsl -->|"transfers packages"| node_ubuntu
node_router -->|"provides DHCP"| node_network
node_proxmox -->|"connects via vmbr0"| node_network
node_ubuntu -->|"connects via vmbr0"| node_network
node_windows -->|"connects via vmbr0"| node_network
node_proxmox -->|"hosts VM"| node_ubuntu
node_proxmox -->|"hosts VM"| node_windows
node_ubuntu -->|"runs"| node_dns
node_ubuntu -->|"runs"| node_ssh
node_windows -->|"uses for DNS"| node_dns
node_ubuntu -->|"resolves lab zones"| node_dns
node_network -->|"blocks access"| node_internet
node_windows -.->|"planned deployment"| node_ad
node_ad -.->|"planned integration"| node_dns
node_admin -.->|"plans deployment"| node_monitoring
node_admin -.->|"plans procedures"| node_backup
node_admin -.->|"plans scripts"| node_automation
node_admin -.->|"plans controls and testing"| node_security

click node_admin "https://github.com/jmpromm/enterprise-home-lab/blob/main/README.md"
click node_wsl "https://github.com/jmpromm/enterprise-home-lab/blob/main/README.md"
click node_router "https://github.com/jmpromm/enterprise-home-lab/blob/main/README.md"
click node_network "https://github.com/jmpromm/enterprise-home-lab/blob/main/README.md"
click node_proxmox "https://github.com/jmpromm/enterprise-home-lab/blob/main/README.md"
click node_ubuntu "https://github.com/jmpromm/enterprise-home-lab/blob/main/README.md"
click node_dns "https://github.com/jmpromm/enterprise-home-lab/blob/main/README.md"
click node_ssh "https://github.com/jmpromm/enterprise-home-lab/blob/main/README.md"
click node_windows "https://github.com/jmpromm/enterprise-home-lab/blob/main/README.md"
click node_ad "https://github.com/jmpromm/enterprise-home-lab/blob/main/README.md"
click node_monitoring "https://github.com/jmpromm/enterprise-home-lab/blob/main/README.md"
click node_backup "https://github.com/jmpromm/enterprise-home-lab/blob/main/README.md"
click node_automation "https://github.com/jmpromm/enterprise-home-lab/blob/main/README.md"
click node_security "https://github.com/jmpromm/enterprise-home-lab/blob/main/README.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_admin,node_wsl toneBlue
class node_proxmox toneAmber
class node_router,node_network,node_dns toneMint
class node_ubuntu,node_ssh,node_windows toneRose
class node_ad,node_monitoring,node_backup,node_automation,node_security,node_internet toneIndigo
```

## Components

### Administration

- [Management Workstation](https://github.com/jmpromm/enterprise-home-lab/blob/main/README.md): `README.md`
- [WSL Package Staging](https://github.com/jmpromm/enterprise-home-lab/blob/main/README.md): `README.md`

### Virtualization

- [Proxmox Host](https://github.com/jmpromm/enterprise-home-lab/blob/main/README.md): `README.md`

### Network Services

- [Lab Router](https://github.com/jmpromm/enterprise-home-lab/blob/main/README.md): `README.md`
- [Isolated Lab Network](https://github.com/jmpromm/enterprise-home-lab/blob/main/README.md): `README.md`
- [BIND9 DNS](https://github.com/jmpromm/enterprise-home-lab/blob/main/README.md): `README.md`

### Server Workloads

- [Ubuntu Server VM](https://github.com/jmpromm/enterprise-home-lab/blob/main/README.md): `README.md`
- [OpenSSH](https://github.com/jmpromm/enterprise-home-lab/blob/main/README.md): `README.md`
- [Windows Server VM](https://github.com/jmpromm/enterprise-home-lab/blob/main/README.md): `README.md`

### Planned Capabilities

- [Active Directory](https://github.com/jmpromm/enterprise-home-lab/blob/main/README.md): `README.md`
- [Monitoring and Logging](https://github.com/jmpromm/enterprise-home-lab/blob/main/README.md): `README.md`
- [Backup and Recovery](https://github.com/jmpromm/enterprise-home-lab/blob/main/README.md): `README.md`
- [Automation](https://github.com/jmpromm/enterprise-home-lab/blob/main/README.md): `README.md`
- [Security and Testing](https://github.com/jmpromm/enterprise-home-lab/blob/main/README.md): `README.md`

### Other components

- **Internet**

## Connections

- Management Workstation → Proxmox Host: administers (evidence: `README.md`)
- Management Workstation → Ubuntu Server VM: remote administration (evidence: `README.md`)
- Management Workstation → Windows Server VM: manages and tests (evidence: `README.md`)
- Management Workstation → WSL Package Staging: stages packages (evidence: `README.md`)
- WSL Package Staging → Ubuntu Server VM: transfers packages (evidence: `README.md`)
- Lab Router → Isolated Lab Network: provides DHCP (evidence: `README.md`)
- Proxmox Host → Isolated Lab Network: connects via vmbr0 (evidence: `README.md`)
- Ubuntu Server VM → Isolated Lab Network: connects via vmbr0 (evidence: `README.md`)
- Windows Server VM → Isolated Lab Network: connects via vmbr0 (evidence: `README.md`)
- Proxmox Host → Ubuntu Server VM: hosts VM (evidence: `README.md`)
- Proxmox Host → Windows Server VM: hosts VM (evidence: `README.md`)
- Ubuntu Server VM → BIND9 DNS: runs (evidence: `README.md`)
- Ubuntu Server VM → OpenSSH: runs (evidence: `README.md`)
- Windows Server VM → BIND9 DNS: uses for DNS (evidence: `README.md`)
- Ubuntu Server VM → BIND9 DNS: resolves lab zones (evidence: `README.md`)
- Isolated Lab Network → Internet: blocks access (evidence: `README.md`)
- Windows Server VM → Active Directory: planned deployment (evidence: `README.md`)
- Active Directory → BIND9 DNS: planned integration (evidence: `README.md`)
- Management Workstation → Monitoring and Logging: plans deployment (evidence: `README.md`)
- Management Workstation → Backup and Recovery: plans procedures (evidence: `README.md`)
- Management Workstation → Automation: plans scripts (evidence: `README.md`)
- Management Workstation → Security and Testing: plans controls and testing (evidence: `README.md`)
