From aaded54074a8b42b7de4631771a2801338008d45 Mon Sep 17 00:00:00 2001
From: nathan <nathan@castaldifamily.com>
Date: Sat, 11 Apr 2026 23:44:19 -0400
Subject: [PATCH] docs(nodes): add hardware specifications to node READMEs

Hardware details gathered via SSH using standard Linux commands:
- lscpu (CPU architecture and core count)
- free -h (memory capacity)
- df -h (storage capacity)
- lspci (GPU identification for Waldorf)
- uname -r (kernel version)
- cat /etc/os-release (OS distribution)

Improves infrastructure documentation for capacity planning and troubleshooting.
---
 nodes/heimdall/README.md   | 21 ++++++++++++++++++++-
 nodes/waldorf/README.md    | 29 ++++++++++++++++++++++++++++-
 nodes/watchtower/README.md | 22 +++++++++++++++++++++-
 3 files changed, 69 insertions(+), 3 deletions(-)

diff --git a/nodes/heimdall/README.md b/nodes/heimdall/README.md
index f6b3c13..548cdb6 100644
--- a/nodes/heimdall/README.md
+++ b/nodes/heimdall/README.md
@@ -1 +1,20 @@
-# heimdall info
\ No newline at end of file
+# Heimdall
+
+> **Primary Services:** Komodo Core, Gitea, Traefik  
+> **IP Address:** 10.0.0.151
+
+## Hardware Specifications
+
+| Component | Details |
+|-----------|---------|
+| **Platform** | Proxmox VM |
+| **CPU** | Intel N100 (4 cores, x86_64) |
+| **Memory** | 16 GB |
+| **Storage** | 98 GB (LVM) |
+| **Operating System** | Ubuntu 24.04.4 LTS (Noble Numbat) |
+| **Kernel** | 6.8.0-107-generic |
+| **Network** | 10.0.0.151 (primary), Docker networks |
+
+## Services
+
+Refer to the [core](core/) directory for deployed stacks.
\ No newline at end of file
diff --git a/nodes/waldorf/README.md b/nodes/waldorf/README.md
index da9c7a2..4c8b71d 100644
--- a/nodes/waldorf/README.md
+++ b/nodes/waldorf/README.md
@@ -1 +1,28 @@
-# waldorf info
+# Waldorf
+
+> **Primary Services:** Plex Media Server, Tunarr  
+> **IP Address:** 10.0.0.251
+
+## Hardware Specifications
+
+| Component | Details |
+|-----------|--------|
+| **Platform** | Physical Server |
+| **CPU** | Intel Core i7-7820HQ @ 2.90GHz (4 cores, 8 threads, x86_64) |
+| **GPU** | NVIDIA GeForce GTX 1060 Mobile Rev. 2 (6GB) |
+| **Memory** | 16 GB |
+| **Storage** | 98 GB (LVM) |
+| **Operating System** | Ubuntu 24.04.4 LTS (Noble Numbat) |
+| **Kernel** | 6.8.0-107-generic |
+| **Network** | 10.0.0.251 (primary), Docker networks |
+
+## GPU Acceleration
+
+- **Device:** `/dev/dri` passthrough enabled for hardware transcoding
+- **Purpose:** Plex hardware-accelerated video transcoding
+- **Driver:** NVIDIA proprietary drivers
+
+## Services
+
+- [Plex Media Server](plex/) - Media streaming with GPU transcoding
+- [Tunarr](tunarr/) - IPTV channel management
diff --git a/nodes/watchtower/README.md b/nodes/watchtower/README.md
index 5aa759f..c4efe07 100644
--- a/nodes/watchtower/README.md
+++ b/nodes/watchtower/README.md
@@ -1 +1,21 @@
-# watchtower info
+# Watchtower
+
+> **Primary Services:** Komodo Periphery  
+> **IP Address:** 10.0.0.200
+
+## Hardware Specifications
+
+| Component | Details |
+|-----------|--------|
+| **Platform** | Raspberry Pi 5 |
+| **CPU** | ARM Cortex-A76 (4 cores, aarch64) |
+| **Memory** | 16 GB |
+| **Storage** | 32 GB microSD (mmcblk0) |
+| **Operating System** | Debian GNU/Linux 13 (Trixie) |
+| **Kernel** | 6.12.75+rpt-rpi-2712 |
+| **Network** | 10.0.0.200 (primary), Docker networks |
+| **Additional IPs** | 10.0.0.80, 10.0.0.79 |
+
+## Role
+
+Periphery node for Komodo distributed container management.