lfg2025/gashboard

Files

Dorian 2dc9be4678 chore: scaffold pnpm workspace, container, deploy docs

Two-app pnpm workspace for the gashboard (mining dashboard) project:
@gashboard/api (Express 5 + TS) and @gashboard/web (Vue 3 + Vite + TS).
Shared tsconfig.base.json. Multi-stage Dockerfile (node:22.12-alpine,
non-root, healthchecked) and docker-compose.yml ready to deploy as a
Portainer Stack on Umbrel — joins umbrel_main_network so it can reach
the Datum container directly. .env.example documents every var; README
covers the Portainer deploy flow and the security posture.

Note: Dockerfile has a TODO marker to SHA256-pin the base image before
shipping to production.

Co-Authored-By: Claude Opus 4.7 (1M context) <noreply@anthropic.com>

2026-05-06 15:57:57 +01:00

2.7 KiB

Raw Blame History

gashboard

a custom dashboard for the datum gateway running on umbrel. for the four little boards that probably won't find a block, but are trying their best.

Polls a local Datum gateway (OCEAN's open-source mining gateway), shows live per-miner hashrate, share counts, lottery odds, and a tongue-in-cheek read on how unlikely it all is. Designed for a small fleet of solo-style hobby miners (Bitaxe, NerdQAxe, Avalon Nano 3, Avalon Mini 3) hashing into one Datum on Umbrel.

What it shows

Pool hero — combined hashrate, current block height being templated, mempool fee snapshot, datum connection status.
Per-miner cards — nickname, ASIC type, location, live hashrate, accepted/rejected shares, last-share age, status light, firmware string from useragent.
Lottery widget — P(block in 24h) at current network difficulty, with rotating self-deprecating commentary.
Live share ticker — sparkline + scrolling feed of recent accepted shares.
Sats-today counter — earnings projection from current hashrate × network reward.
Map panel — pins for each location (split by remote IP from Datum's /clients), pulse-per-share.
Block celebration — confetti + sound the day it finally happens.

Auth

Nostr-only login (NIP-98 over HTTP). Two signers supported:

Remote signer (NIP-46) — covers Primal app, Amber, nsecbunker.
Browser extension (NIP-07) — Alby, nos2x, etc.

Allowlist of npubs is set via NOSTR_ALLOWED_NPUBS. Anything else is rejected before a session token is issued.

Stack

Frontend — Vue 3 + Vite + Pinia + TypeScript
Backend — Express + TypeScript
Auth — nostr-tools (NIP-98 verify), applesauce-* (signer abstraction, lifted from indeehub)
Container — multi-stage node:22.12.0-alpine (pinned by SHA256 in Dockerfile)

Deploy on Portainer (the way it'll actually run)

Enable Datum admin API on your Umbrel — edit ~/umbrel/app-data/datum-gateway/data/datum_gateway/datum_gateway_config.json and add "admin_password": "<openssl rand -hex 32>" inside the "api" block. Restart the Datum app.
Push this repo to your gitea/whatever:
```
git push -u origin main
```
In Portainer → Stacks → Add stack → Repository:
- Repository URL: https://git.tx1138.com/lfg2025/gashboard
- Compose path: docker-compose.yml
- Add env vars (see .env.example)
- Set the external network in the compose file to match your Datum app's docker network (find with docker network ls on the Umbrel)
Open the dashboard, log in with one of the allowed npubs, watch your boards lose at hashing in style.

Local dev

pnpm install
pnpm dev    # runs api + web concurrently

License

MIT.

2.7 KiB Raw Blame History Unescape Escape