GSM/CLAUDE.md

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)
• V Rising Server (192.168.2.52): Dedicated server (LXC)
• Palworld Server (192.168.2.53): Dedicated server with systemd (LXC)
• Project Zomboid Server (10.0.30.66): Dedicated server (external 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, Auto-Shutdown, Config-Editoren
• superadmin: Zusätzlich Nutzerverwaltung, Activity Log, Anzeigeeinstellungen (Verbindungsadresse/Hinweis pro Server)

GSM Features:

• Dashboard mit Server-Karten (Status, Metriken, Spieleranzahl)
• Server-Detailansicht mit Tabs (Übersicht, Metriken, Konsole, Einstellungen, etc.)
• Auto-Shutdown: Server stoppt automatisch wenn keine Spieler online sind
• Config-Editoren: Palworld (INI), Project Zomboid (INI/Lua)
• Factorio Weltverwaltung: Spielstände erstellen/löschen/laden
• Minecraft Whitelist-Verwaltung via RCON
• Anzeigeeinstellungen: Superadmins können Verbindungsadresse und Hinweis pro Server anpassen
• Activity Log: Protokolliert alle Aktionen mit Discord-Avatar

Domain: zeasy.dev with subdomains managed via Cloudflare DDNS (gsm.zeasy.dev, factorio.zeasy.dev, palworld.zeasy.dev, pz.zeasy.dev)

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

Language Note

Documentation is written in German.