# Ham Lab

Web-based Linux management console for bare-metal Debian, in the style of the Proxmox
web UI. Named after Ham the cat (see also HamTV).

Status: **v0.1** — persistent web terminals and a live Dashboard tab. Scope and roadmap in
[`PLAN.md`](PLAN.md).

## Runs on any Linux box

One static Go binary with the UI embedded; no cgo, no Node at runtime, no agents. The
Dashboard reads `/proc` and `/sys` directly (CPU, memory, hwmon or thermal-zone temps,
fans, NICs, block devices, mounts) so it works the same on x86 and ARM, bare metal or VM,
and just leaves a section empty when the hardware has nothing to report. UPS status is
optional and picked up from whichever of `pwrstat`, NUT (`upsc`) or `apcupsd` is
installed.

```sh
make build                      # web + Go, or: make build-arm64 for a cross-compile
./deploy/install.sh             # installs the binary + a systemd unit for the invoking user
hamlab passwd                   # set the login password (config in ~/apps/hamlab/)
sudo systemctl start hamlab     # listens on 127.0.0.1:8100 by default; set "listen" in config.json
```

Terminals run as the user the service runs as, with that user's login shell.

- On `core` it is public at `https://hamlab.bigham.dev` behind Nginx Proxy Manager.
- Installable as a PWA.