From f3b0f07d39f63c3a4d12ddd0fb6b2c7d0f4f10ed Mon Sep 17 00:00:00 2001
From: Spendlik <spendlik@gmail.com>
Date: Wed, 27 May 2026 19:21:35 +0000
Subject: [PATCH] Add homelab overview document

---
 homelab-overview.md | 108 ++++++++++++++++++++++++++++++++++++++++++++
 1 file changed, 108 insertions(+)
 create mode 100644 homelab-overview.md

diff --git a/homelab-overview.md b/homelab-overview.md
new file mode 100644
index 0000000..57d284a
--- /dev/null
+++ b/homelab-overview.md
@@ -0,0 +1,108 @@
+# Homelab Overview
+
+> Last updated: 2026-05-27
+
+---
+
+## Hardware
+
+| Property | Value |
+|---|---|
+| **CPU** | AMD Ryzen 7 5700G (8 cores / 16 threads) |
+| **RAM** | 32 GB DDR4 |
+| **Root Disk** | ~94 GB (47.9 GB used / 52.9 GB free) |
+| **Architecture** | x86_64 |
+| **Virtualization** | AMD-V (HVM enabled) |
+| **Boot Mode** | EFI |
+
+---
+
+## Software
+
+| Property | Value |
+|---|---|
+| **Hypervisor** | Proxmox VE 9.1.4 |
+| **Kernel** | Linux 6.14.11-5-pve (SMP PREEMPT_DYNAMIC) |
+| **Swap** | 8 GB (133 MB used) |
+
+---
+
+## LXC Containers
+
+All containers are currently **running**.
+
+| ID | Name | CPUs | RAM Alloc | Disk Alloc | Tags |
+|---|---|---|---|---|---|
+| 100 | n8n | 2 | 2 GB | 9.7 GB | automation |
+| 101 | reverse-proxy | 1 | 512 MB | 7.8 GB | network |
+| 102 | authelia | 1 | 512 MB | 7.8 GB | authentication, network |
+| 103 | matrix-synapse | 2 | 2 GB | 19.5 GB | communication, messaging |
+| 104 | snappymail | 1 | 512 MB | 3.9 GB | email, webserver |
+| 105 | audiobookshelf | 2 | 1 GB | 15.6 GB | ebooks, comics |
+| 106 | jellyfin | 4 | 2 GB | 19.5 GB | movies |
+| 107 | wireguard | 1 | 256 MB | 7.8 GB | network |
+| 108 | ddns | 1 | 128 MB | 3.9 GB | network |
+| 109 | gitea | 1 | 512 MB | 7.8 GB | development |
+| 112 | mcp-server | 1 | 512 MB | 7.8 GB | — |
+| 113 | appflowy | 2 | 2 GB | 19.5 GB | — |
+
+### Container Notes
+
+- **n8n** — Workflow automation platform, tagged as community-script
+- **reverse-proxy** — Handles all inbound traffic routing (high net I/O)
+- **authelia** — SSO / two-factor authentication gateway
+- **matrix-synapse** — Self-hosted Matrix homeserver for messaging
+- **snappymail** — Lightweight webmail client (PHP/webserver stack)
+- **audiobookshelf** — Audiobook and ebook server
+- **jellyfin** — Media server (highest RAM consumer among LXCs at ~2 GB allocated)
+- **wireguard** — VPN server
+- **ddns** — Dynamic DNS updater
+- **gitea** — Self-hosted Git service (this repo lives here)
+- **mcp-server** — MCP server exposing Proxmox and Gitea tools to Claude AI
+- **appflowy** — Self-hosted AppFlowy instance (notes / project management)
+
+---
+
+## Virtual Machines
+
+| ID | Name | CPUs | RAM Alloc | Disk Alloc | Status |
+|---|---|---|---|---|---|
+| 110 | windows11 | 4 | 8 GB | 120 GB | Running |
+
+---
+
+## Network Architecture
+
+```
+Internet
+   │
+   ▼
+[DDNS] ──► dynamic DNS updates
+   │
+   ▼
+[Reverse Proxy (101)] ──► routes traffic to all services
+   │
+   ├──► [Authelia (102)]       — authentication layer
+   ├──► [Jellyfin (106)]       — media
+   ├──► [Audiobookshelf (105)] — ebooks/audiobooks
+   ├──► [Matrix Synapse (103)] — messaging
+   ├──► [Snappymail (104)]     — webmail
+   ├──► [AppFlowy (113)]       — notes
+   ├──► [Gitea (109)]          — git
+   ├──► [n8n (100)]            — automation
+   └──► [MCP Server (112)]     — Claude AI integration
+   
+[WireGuard (107)] — VPN access to homelab
+```
+
+---
+
+## Claude AI Integration
+
+The **mcp-server** container (ID 112) exposes a Model Context Protocol (MCP) server at `mcp.spendlik.sk`, providing Claude with tools to:
+
+- List, start, and stop Proxmox containers and VMs
+- Read node resource usage
+- Browse and edit Gitea repositories
+
+This `Claude_Homelab` Gitea repository serves as a persistent knowledge base for Claude, storing homelab documentation, project context, and configuration references used across Claude Project sessions.