Claude_Homelab/homelab-overview.md

3.8 KiB

Homelab Overview

Last updated: 2026-05-31


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
111 paperless 2 2 GB 19.5 GB documents
112 mcp-server 1 512 MB 7.8 GB ai

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)
  • paperless — Paperless-ngx document management for ~500 modelling magazines. Consume/export via NAS mount. OCR in slk, ces, rus, hun, deu, eng.
  • mcp-server — MCP server exposing Proxmox and Gitea tools to Claude AI

Virtual Machines

ID Name CPUs RAM Alloc Disk Alloc Status
110 windows11 4 8 GB 120 GB Running

NAS Storage Mounts

Container NAS Path Mount Point Method
audiobookshelf (105) /volume1/proxmox/data/ebooks /mnt/ebooks Proxmox bind mount
jellyfin (106) /volume1/video /mnt/video fstab NFS + bind mount
paperless (111) /volume1/proxmox/data/paperless /mnt/paperless Proxmox bind mount

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
   ├──► [Gitea (109)]          — git
   ├──► [n8n (100)]            — automation
   ├──► [Paperless (111)]      — document management
   └──► [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.