# Homelab Overview

> Last updated: 2026-05-29

---

## 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 | 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)
- **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 |

---

## 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
   └──► [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.