Mitchell-JohnsonandClaude Fable 5.1
7053cce7fe
Co-Authored-By: Claude Fable 5.1 <noreply@anthropic.com>
29 lines
1.3 KiB
Markdown
29 lines
1.3 KiB
Markdown
# 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.
|