diff --git a/README.md b/README.md
new file mode 100644
index 0000000..9eff444
--- /dev/null
+++ b/README.md
@@ -0,0 +1,90 @@
+## Proxmox Cluster (3-Node)
+
+### PVE1 - "The Powerhouse"
+- **Hardware:** Lenovo ThinkCentre M710q Tiny
+- **CPU:** Intel i5-7500T (4 cores / 4 threads)
+- **RAM:** 32 GB DDR4
+- **STORAGE:** 512 GB NVMe (boot), 1 TB SSD (storage)
+- **Networking:** 2.5 GbE (main) 1 GbE
+- **Role:** Heavy Compute (n8n, Gitea, Prowlarr, Changedetection)
+
+### PVE2 - "The Infrastructure Hub"
+- **Hardware:** Lenovo ThinkCentre M710q Tiny
+- **CPU:** Intel i5-7500T (4 cores / 4 threads)
+- **STORAGE:** 256 GB NVMe (boot), 1 TB SSD (storage)
+- **RAM:** 24 GB DDR4
+- **Networking:** 2.5 GbE (main) 1 GbE
+- **Role:** Management & Edge Services (NPM, Vaultwarden, Wiki.js, Koffan, Gluetun, Mealie, MeshCentral, UptimeKuma)
+
+### PVE3 - "The Backup Vault & Quorum"
+- **Hardware:** Lenovo ThinkCentre M93p Tiny
+- **CPU:** Intel 4th Gen (Haswell) i5/i7 (i5-4570T)
+- **RAM:** 16 GB DDR3
+- **Storage:** 2 TB SSD (Primary Backup Repository)
+- **Networking:** 1 GbE
+- **Role:** Proxmox Backup Server (PBS) + Cluster Quorum
+
+---
+
+## TrueNAS
+
+- **OS Version:** 25.10.0
+- **Motherboard:** MSI MS-7C95
+- **CPU:** AMD Ryzen 5 5600G with Radeon Graphics
+- **RAM:** 27 GiB
+- **Network:** 2.5 GbE
+- **GPU:** NVIDIA RTX 3070 8 GB
+
+### Storage Pools
+- **RAIDZ1:** 4x 14 TB HDD (~42 TB raw)
+- **RAIDZ1:** 4x 8 TB HDD (~24 TB raw)
+- **Cache:** 1x 1 TB NVMe
+- **Metadata:** 1x 1 TB NVMe
+
+### Apps
+- audiobookshelf, dozzle, immich, jellyfin, lidarr, mumble, ollama (not in use), plex, qbittorrent (with gluetun), radarr, sabnzbd, seer, sonarr, tdarr (not setup/in-use yet)
+
+---
+
+## HomeAssistant
+
+- **Hardware:** Lenovo ThinkCentre M710q Tiny
+- **CPU:** Intel i5-7500T (4 cores / 4 threads)
+- **RAM:** 8 GB DDR4
+- **STORAGE:** 256 GB NVMe
+- **Networking:** 1 GbE
+
+---
+
+## Network Attached Storage
+
+### LEDNAS01 - QNAP TS869L
+- **Drives:** 8x 4 TB in RAID 6
+- **Usable:** ~21.5 TB
+- **RAM:** 4 GB
+- **Role:** General storage
+
+### LEDNAS02 - Synology DS916+
+- **Drives:** 4x 3 TB in SHR
+- **Usable:** ~8.2 TB
+- **RAM:** 8 GB
+- **Role:** Veeam backup target
+
+---
+
+## Raspberry Pis
+
+### Unused Host
+- **Model:** Raspberry Pi 5 8GB
+
+### PiHole
+- **Model:** Raspberry Pi 4
+- **Role:** DNS/Ad-blocking (PiHole)
+
+---
+
+## Workstations & Clients
+- **LEDWS01-ROB:** Main workstation + gaming PC
+- **Tiny PC (Work):** Work-related tasks
+- **Tiny PC (Veeam):** Veeam backup server
+- **Laptops:** Additional client machines
\ No newline at end of file