jhodgkin a431b87f1f
CI / web (push) Successful in 19s
CI / api (push) Successful in 28s
Add Authentik OIDC login as an additional sign-in option
Local auth stays the primary/always-available login (don't want to
lock out the saved admin password) — OIDC is additive, shown as a
second button when OIDC_ENABLED=true. Uses openid-client v6 with PKCE.

Authentik-side provider was set up via an authentik blueprint (its own
declarative automation, see docs/oidc-setup.md) rather than touching
any existing admin credentials.

Closes #12.

Co-Authored-By: Claude Sonnet 5 <noreply@anthropic.com>
2026-07-12 20:59:25 -06:00

Homelab Monitor

A single dashboard for the health of everything in the homelab (documented in jhodgkin/homelab): Proxmox host + LXC CPU/mem/disk/pressure, and — as the backlog fills in — SSH-monitored bare-metal boxes, a LAN device inventory, and Zabbix alerts. One login instead of N.

Project status, architecture, and how to resume work: see CLAUDE.md. Roadmap: Gitea issues, milestone v1-dashboard.

Local development

# terminal 1
cd apps/api && npm install && cp ../../.env.example ../../.env  # fill in .env first
npm run dev

# terminal 2
cd apps/web && npm install && npm run dev

Web dev server proxies /api to localhost:3000 (see apps/web/vite.config.ts).

Production deploy

Runs as Docker Compose on CT122 (homelab-monitor, 192.168.1.103):

ssh homelab-monitor
cd /opt/homelab-monitor
git pull
docker compose up -d --build
S
Description
Unified dashboard for monitoring the homelab: server health, resource usage, and LAN device inventory.
Readme 454 KiB
Languages
TypeScript 87.1%
Shell 6.9%
CSS 4.9%
Dockerfile 0.8%
HTML 0.3%