oskar/homelab-codex-ws
1
0
Fork 0
Code Issues Pull requests Actions Packages Projects Releases Wiki Activity
4 commits 17 branches 4 tags 914 KiB
Python 75.6%
Shell 14.6%
HTML 9.3%
Dockerfile 0.5%
Find a file
Oskar Kapala 12397f6605 Add session context state
2026-04-20 22:10:39 +02:00
docs Document VPS connectivity diagnostics 2026-04-15 20:38:09 +02:00
.codex Document current homelab state 2026-04-15 17:37:25 +02:00
.gitignore Add session context state 2026-04-20 22:10:39 +02:00
codex_context Add session context state 2026-04-20 22:10:39 +02:00
codex_context.yaml Add session context state 2026-04-20 22:10:39 +02:00
README.md Document Hetzner VPS handoff 2026-04-15 17:46:42 +02:00

README.md

Homelab Current State

Description

This repository documents the current known state of the homelab.

The documentation is based only on stated facts. Missing details are recorded as unknowns and need clarification.

Current configuration

  • Main server hardware: Raspberry Pi 5
  • Core stack:
    • Docker
    • Portainer
    • Nginx Proxy Manager
  • Network position: behind NAT
  • Public access path: Nginx Proxy Manager with HTTPS using Let's Encrypt
  • Private access path: Tailscale
  • Known port forwarding:
    • External ports 80-81 forward to internal ports 4480-4481
    • External port 443 forwards to internal port 4443

Documentation index

Known facts

  • The homelab has one known main server: Raspberry Pi 5.
  • Docker is part of the current stack.
  • Portainer is part of the current stack.
  • Nginx Proxy Manager is part of the current stack.
  • The homelab is behind NAT.
  • Public services are exposed through Nginx Proxy Manager with HTTPS certificates from Let's Encrypt.
  • Private access is provided through Tailscale.
  • A Hetzner VPS handoff has been received from another Codex session.
  • The Hetzner VPS hostname is ubuntu-4gb-hel1-1.
  • The Hetzner VPS Tailscale IP is 100.95.58.48.
  • 100.108.208.3 is explicitly not the Hetzner VPS Tailscale IP.
  • Nginx Proxy Manager is running on the Hetzner VPS as container npm.
  • Joplin Server files exist on the Hetzner VPS, but Joplin is not running yet.

Unknown / needs clarification

  • Operating system and version on the Raspberry Pi 5.
  • Storage layout and attached disks.
  • Network interface configuration.
  • LAN IP addresses.
  • Public domain names for the Raspberry Pi 5 services.
  • List of all running containers.
  • Exact Nginx Proxy Manager proxy host configuration.
  • Tailscale tailnet, device name, and subnet/exit-node configuration if any.
  • Backup configuration.
  • Monitoring and alerting configuration.
  • Whether the Hetzner VPS is part of the homelab, a separate public edge, or both.