homelab-codex-ws/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

• Hardware
• Core stack
• Networking
• Access
• Services
• Unknowns and clarification questions

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.

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.
• 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.