# 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](docs/hardware.md)
- [Core stack](docs/core-stack.md)
- [Networking](docs/networking.md)
- [Access](docs/access.md)
- [Services](docs/services.md)
- [Unknowns and clarification questions](docs/questions.md)

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