ThunderHub

Introduction

ThunderHub is an open-source Lightning Network node manager. It provides a web-based interface to monitor and manage your LND or Lightning Terminal (litd) node from any device or browser.

Integrations

ThunderHub is integrated into several popular node platforms:

• BTCPay Server  — Included as part of the BTCPay Server deployment stack.
• Raspiblitz  — Available as an optional service on Raspiblitz nodes.
• myNode  — Bundled with the myNode software suite.
• Voltage  — Available on Voltage’s hosted Lightning node platform.
• Umbrel  — Installable from the Umbrel App Store.

Tech Stack

ThunderHub is a full-stack TypeScript application with a NestJS backend serving a GraphQL API and a React frontend. It connects to Lightning Network nodes via gRPC.

• Backend — NestJS, GraphQL (Apollo Server), Drizzle ORM
• Frontend — React, Vite, Tailwind CSS, Apollo Client
• Language — TypeScript

Features

Monitoring

• Balance overview for Lightning and on-chain wallets (current and pending).
• Node URI strings including Tor onion addresses.
• Invoice, payment, and forwarding graphs.
• Liquidity report showing total remote and local channel balance.
• Channel list with balance indicators (open, pending, and closed).
• Fee policies per channel (base fee and fee rate).
• Transaction history, chain transactions, and UTXO list.
• Network information overview.

Management

• Send and receive Lightning payments.
• Send and receive on-chain Bitcoin.
• Open and close channels.
• Decode payment requests.
• Update channel fees (individually or in bulk).
• Channel rebalancing via circular payments.
• Channel backup, verification, and recovery.
• Sign and verify messages.
• LNURL support (lnurl-pay, lnurl-withdraw).
• Macaroon management.

Taproot Assets

• Mint, burn, and transfer Taproot Assets.
• Create invoices denominated in Taproot Assets.
• Asset universe management and federation.
• Trading offers for asset exchange.
• View asset balances and transfer history.

Swaps

• Submarine swaps and reverse swaps via Boltz .

Security

• Two-factor authentication (2FA) with TOTP.
• AES-encrypted macaroon support.
• Password hashing (cleartext passwords are never stored).
• SSO cookie-based authentication.

Interface

• Responsive design for mobile, tablet, and desktop.
• Light and dark themes.
• Display values in satoshis, BTC, or fiat currencies.
• Customizable dashboard layout.

Accounts

• Connect via macaroon file paths or HEX/Base64 strings.
• Manage multiple nodes from a single instance.
• Master password or per-account passwords.
• Optional database-backed user accounts with team support (SQLite or PostgreSQL).

Deployment

• Docker images available on Docker Hub .
• Reverse proxy support with configurable base path.
• Tor proxy support for outbound requests.