Files

Alexander Zielonka 2b1fbb9f02 Initial commit: Homelab documentation

- infrastructure.md: Network topology, server overview, credentials
- gsm.md: Gameserver Monitor detailed documentation
- todo.md: Project roadmap and completed tasks
- CLAUDE.md: AI assistant context
- temp/: Frontend component backups

🤖 Generated with [Claude Code](https://claude.com/claude-code)

Co-Authored-By: Claude Opus 4.5 <noreply@anthropic.com>

2026-01-05 06:16:05 +01:00

1.5 KiB

Raw Blame History

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.