Introduction
ThunderHub is an open-source web manager for Lightning Network nodes — connect to LND or Lightning Terminal (litd) and manage channels, payments, Taproot Assets, and trading from one interface.
ThunderHub is an open-source web interface for Lightning Network node operators. Point it at an LND or Lightning Terminal (litd) node and get channel management, payments, on-chain operations, Taproot Assets, and Magma-powered asset trading — from any browser.
Features
| Area | What you get |
|---|---|
| Monitor | Balances (Lightning + on-chain), node URI with Tor address, invoice/payment/forward graphs, channel list with policies, transaction history, UTXOs, network info. |
| Manage | Send and receive Lightning + on-chain, open/close channels, bulk-update fees, circular rebalancing, channel backups, sign/verify messages, LNURL, macaroon bakery. |
| Taproot Assets | List, mint, burn, send, receive, asset invoices, universe sync, federation management, per-channel asset balances. |
| Trade | Magma RFQ orders — buy and sell Taproot Assets with multi-hop circular rebalancing, pending channel tracking, per-channel notes. |
| Secure | TOTP 2FA, AES-encrypted macaroons, bcrypt-hashed YAML passwords, Argon2-hashed DB users, AES-256-GCM at-rest encryption for DB-stored node credentials, SSO cookie auth. |
| Interface | Responsive UI for mobile / tablet / desktop, light + dark themes, satoshi / BTC / fiat display, customizable dashboard. |
How you can connect
ThunderHub supports three login modes that can be mixed in a single deployment:
| Mode | Best for | Where credentials live |
|---|---|---|
| YAML accounts | Single-operator self-hosters | A thubConfig.yaml file on disk |
| Database users | Multi-user setups, UI-driven node management | SQLite or Postgres with AES-256-GCM-encrypted node credentials |
| LiT SSO | Inside Lightning Terminal's UI | Macaroon + cookie from the LiT process |
See Accounts for the full picture.
Tech stack
ThunderHub is a TypeScript monorepo. The server is a NestJS 11 app that exposes a GraphQL API and talks to your node over gRPC. The client is a React 18 + Vite SPA styled with Tailwind v4 and shadcn/ui. Optional persistence runs on Drizzle ORM backed by SQLite or PostgreSQL.
Docker images for linux/amd64 and linux/arm64 are published to Docker Hub. A ready-to-deploy fly.toml ships in the repo.
Where to go next
- Get Started — Install ThunderHub via Docker, from source, on Fly.io, or connect it to Voltage.
- Accounts — Decide how operators log in and how nodes are connected.
- Configure — Server, database, security, and reverse-proxy settings.
- Taproot Assets — Mint, transfer, and trade assets via Magma RFQ.
- Reference — Every environment variable and YAML field, grouped.
Integrations
ThunderHub is shipped by several node platforms out of the box:
- BTCPay Server — Included in the BTCPay deployment stack.
- Raspiblitz — Optional service on Raspiblitz.
- myNode — Bundled with myNode.
- Voltage — Available on Voltage's hosted node platform.
- Umbrel — Installable from the Umbrel App Store.