Homelab infrastructure documentation and management
Find a file
Mikkel Georgsen 6ebdb4a555 feat(03-02): wire suspend/resume lifecycle with race locks, startup cleanup, and graceful shutdown
- Added suspend_session() callback for idle timer (terminates subprocess, updates metadata to suspended, silent)
- Added get_subprocess_lock() helper to prevent race between timeout and user message
- Updated handle_message/handle_photo/handle_document with resume logic (detects suspended, shows 'Resuming session...', spawns with --continue)
- Added idle timer reset in on_complete callback (timer only starts after Claude finishes)
- Added idle timer reset on user activity (message/photo/document)
- Updated new_session() to initialize idle timer after subprocess creation
- Updated switch_session_cmd() to initialize idle timer when auto-spawning subprocess
- Updated archive_session_cmd() to cancel idle timer and remove subprocess lock
- Updated model_cmd() to cancel idle timer when terminating subprocess
- Added cleanup_orphaned_subprocesses() to kill orphaned PIDs verified via /proc/cmdline at startup
- Added post_init() callback for startup cleanup
- Added post_shutdown() callback for graceful shutdown (terminates all subprocesses, cancels all timers)
- Updated help text with new commands

Co-Authored-By: Claude Opus 4.5 <noreply@anthropic.com>
2026-02-04 23:36:43 +00:00
.planning docs(03-01): complete idle timer foundation plan 2026-02-04 23:30:28 +00:00
beszel Add Beszel server monitoring dashboard 2026-01-14 23:27:01 +00:00
dns Add API credentials and configs 2026-01-14 12:40:26 +00:00
dockge Add Beszel server monitoring dashboard 2026-01-14 23:27:01 +00:00
forgejo Add API credentials and configs 2026-01-14 12:40:26 +00:00
npm Add API credentials and configs 2026-01-14 12:40:26 +00:00
pve Add API credentials and configs 2026-01-14 12:40:26 +00:00
telegram feat(03-02): wire suspend/resume lifecycle with race locks, startup cleanup, and graceful shutdown 2026-02-04 23:36:43 +00:00
uptime-kuma Add Uptime Kuma helper script and monitors 2026-01-14 23:04:51 +00:00
CLAUDE.md docs: add /model and session commands to help text and CLAUDE.md 2026-02-04 22:43:49 +00:00
homelab-documentation.md docs: update homelab documentation, CLAUDE.md, and TODOs 2026-02-04 22:10:23 +00:00
README.md Add PBS helper script for backup monitoring 2026-01-16 12:10:51 +00:00
TODO.md docs: update homelab documentation, CLAUDE.md, and TODOs 2026-02-04 22:10:23 +00:00

Homelab

Infrastructure documentation and management for Mikkel's homelab.

Files

  • homelab-documentation.md - Complete infrastructure documentation
  • CLAUDE.md - Claude Code guidance and quick reference
  • TODO.md - Pending maintenance tasks

Containers

VMID Name IP
100 npm 10.5.0.1
101 dockge 10.5.0.10
102 mgmt 10.5.0.108
103 postgresql01 DHCP
104 redis01 DHCP
105 sentry DHCP
106 pbs 10.5.0.6
107 pve-scripts-local DHCP
108 jukebox DHCP
110 sense DHCP
111 dev DHCP
112 dataloes 10.5.0.112
113 general 10.5.0.113
114 forgejo 10.5.0.14
115 dns 10.5.0.2
1000 tailscale 10.5.0.x

Management Container

This repository is managed from the mgmt container (VMID 102) on core.georgsen.dk.

Helper scripts available:

  • ~/bin/pve - Proxmox VE API
  • ~/bin/npm-api - Nginx Proxy Manager API
  • ~/bin/dns - Technitium DNS API
  • ~/bin/kuma - Uptime Kuma monitoring API
  • ~/bin/beszel - Beszel server dashboard API
  • ~/bin/pbs - PBS backup status and statistics
Service URL
Proxmox https://core.georgsen.dk:8006
Forgejo https://git.georgsen.dk
DNS Admin https://dns.georgsen.dk
NPM Admin http://10.5.0.1:81
Dockge https://dockge.georgsen.dk
PBS https://pbs.georgsen.dk
Dashboard https://dashboard.georgsen.dk