Appearance
Quick start
Run the whole system on a throwaway regtest chain, on loopback only.
Requirements
- Rust 1.88 or newer
- Node 22 or newer
- Docker
just
Start it
sh
just up # regtest bitcoind + Fulcrum + private relay, a funded "miner" and a "merchant" wallet
just server # builds and runs deadhop; writes dashboard/public/config.json
just dashboard # serves the dashboard at http://127.0.0.1:4173Run npm install in dashboard/ once before just dashboard.
Pay an invoice
Open http://127.0.0.1:4173 and choose Continue as guest.
Enter an amount and choose Create invoice. The page mines proof of work, then shows the QR code and address.
Pay it from the regtest miner wallet. This also mines one block:
shjust pay <address> <sats>The page moves to Payment seen and then Paid on its own.
Sign in as the operator by pasting the key in
data/dev/operator.nsecto see the operator dashboard. To use your own key instead, add it under Settings → Operators, or putDEADHOP_ADMINS=npub1…in.env.local(gitignored; the dev scripts read it on every run). Any other key only gets the invoice form.
Stop it
sh
just down # removes the stack and its chain dataThe development stack uses unpinned images and no authentication. Never use it as a production deployment; see Deployment.