# CLAUDE.md

This file provides guidance to Claude Code (claude.ai/code) when working with code in this repository.

## Repository Purpose

This is a documentation repository for a homelab infrastructure. It contains technical documentation for servers, services, and network configuration - no application code.

## Infrastructure Overview

The homelab consists of:
- **Raspberry Pi (192.168.2.10)**: Runs Nginx Proxy Manager, Cloudflare DDNS, and Nextcloud via Docker
- **Proxmox Server (192.168.2.20)**: Virtualization host running LXC containers and VMs
- **Gameserver Monitor (192.168.2.30)**: React/Node.js webapp for monitoring game servers (LXC)
- **Factorio Server (192.168.2.50)**: Docker-based game server (LXC)
- **Minecraft Server (192.168.2.51)**: ATM10 modded server running via screen (VM)

## Key Technical Details

**Gameserver Monitor Stack**: React + Vite + TailwindCSS frontend, Node.js + Express backend, SQLite for auth, nginx as reverse proxy. Located at `/opt/gameserver-monitor/` on the monitor LXC.

**Gameserver Monitor Rollensystem**:
- `user`: Kann nur Server-Metriken sehen (CPU, RAM, Players, Uptime)
- `moderator`: Zusätzlich Konsole, RCON, Server Start/Stop/Restart
- `superadmin`: Zusätzlich Nutzerverwaltung (User anlegen/löschen, Rollen ändern)

**Domain**: dimension47.de with subdomains managed via Cloudflare DDNS

**SSH Access**: The monitor server (.30) has SSH key access to Proxmox and both game servers for remote management.

## Language Note

Documentation is written in German.