Deployment docs

Run zapsats.ca from lnSwitchboard.

Install lnSwitchboard on Umbrel, include the zapsats-broker sidecar, confirm public inbound liquidity, and register a handle from the dedicated zapsats page inside lnSwitchboard.

Required configuration

Broker and service hostnames are deployment settings.

ZAPSATS_BROKER_URL points lnSwitchboard at the local broker.
ZAPSATS_SERVICE_URL points the broker at the public Worker.
ZAPSATS_AGENT_URL points outbound broker WebSockets at the agent host.
ZAPSATS_SERVICE_DOMAIN controls the registration domain shown in the UI.
BLOCKED_LN_ADDRESS_DOMAINS prevents owned service domains from regular address CRUD.

Before billing

The zapsats page checks broker health, public channels with incoming liquidity, handle availability, terms acceptance, and broker-to-Worker connectivity before asking for an invoice.

Registration

The Worker returns the price and duration, the broker signs the claim with the LND node pubkey, and billing uses LNURL payerdata from the configured billing Lightning Address.

Routing

After payment and claim completion, the broker opens an outbound WebSocket to agent.zapsats.ca so the user's node can create and verify receiving invoices.