# Homelab Monitor

A single dashboard for the health of everything in the homelab (documented in
[`jhodgkin/homelab`](https://git.jerodrigged.com/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`](./CLAUDE.md).
Roadmap: [Gitea issues](https://git.jerodrigged.com/jhodgkin/homelab-monitor/issues), milestone `v1-dashboard`.

## Local development

```bash
# 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):

```bash
ssh homelab-monitor
cd /opt/homelab-monitor
git pull
docker compose up -d --build
```