diff --git a/README.md b/README.md
index e79e5de..cbcbbe6 100644
--- a/README.md
+++ b/README.md
@@ -1,3 +1,37 @@
 # Homelab
 
-If you are viewing on GitHub, you can view this repo on my self-hosted instance of Gitea <a href="https://gitea.dontddos.me/dontddos/homelab">here</a>.
\ No newline at end of file
+If you are viewing on GitHub, you can view this repo on my self-hosted instance of Gitea <a href="https://gitea.dontddos.me/dontddos/homelab">here</a>.
+## 🖥️ Hardware
+
+| Component | Model / Specs                                                     | Role                  |
+| --------- | ----------------------------------------------------------------- | --------------------- |
+| Firewall  | pfsense on pve-01                                                 | Edge firewall, DHCP   |
+| Switch    | Arista DCS-7010T                                                  | Core / L3 switch      |
+| PVE-01    | HPE ProLiant DL360 Gen 9<br>2x Intel Xeon E5-2673 v3<br>128GB RAM | Virtualisation server |
+| TrueNAS   | AMD FX-6100<br>24GB RAM<br>8TB Storage                            | Storage               |
+
+##  🚀 Services, Applications & Deployments
+### Infrastructure
+- **Proxmox VE** - Type 1 hypervisor
+- **Docker** - Containerisation 
+
+### Networking
+- **pfSense** - Edge firewall, DHCP
+- **AdGuard Home** - DNS
+- **Nginx** - Proxy for internal HTTP traffic
+- **Tailscale** - Remote access via VPN
+
+### Security
+- **Vaultwarden** - Password manager
+- **CrowdSec** - Intrusion prevention
+- **Wazuh** - Security monitoring and SIEM
+
+### Storage
+- **TrueNAS** - NAS solution
+
+## 🌐 Network Architecture 
+**Key Features:**
+- Segmented VLANs for security and organization
+- Arista DCS-7010T providing L3 switching
+- pfSense handling firewall rules and DHCP
+- AdGuard Home for DNS filtering across all VLANs
\ No newline at end of file