Installation

Want a public URL in minutes? Skip the local install and follow our Deploy to Fly.io guide. ThunderHub runs in the cloud and connects to any Lightning node you can reach.

Using an AI coding agent? Drop our ready-made AGENTS.md into your ThunderHub repo root and your agent can handle the full setup for you — including litd and Taproot Assets.

Requirements

Node.js version 24 or higher
npm

ThunderHub v0.15.0+ requires Node.js 24+.

From Source

Clone the repository and build:


git clone https://github.com/apotdevin/thunderhub.git
cd thunderhub
npm install
npm run build
npm start

The application starts on port 3000 by default. Open http://localhost:3000 in your browser.

To use a different port, set the PORT environment variable:


PORT=4000 npm start

For production deployments, you can reduce disk usage by pruning development dependencies after the build:


npm prune --production

Updating

Run all commands from inside the thunderhub directory.

Script

bash copy npm run update

Docker

Docker images are published to Docker Hub . Images are available for linux/amd64 and linux/arm64 platforms.

Support for linux/arm/v7 (32-bit ARM) was dropped in v0.15.0. If you were running ThunderHub on a 32-bit ARM device, you will need to upgrade your hardware or use a different deployment method.


docker pull apotdevin/thunderhub:v0.15.5
docker run --rm -it -p 3000:3000 apotdevin/thunderhub:v0.15.5

Or use latest to always pull the most recent release:


docker pull apotdevin/thunderhub:latest
docker run --rm -it -p 3000:3000 apotdevin/thunderhub:latest

Open http://localhost:3000 to access ThunderHub.

The Docker image runs as a non-root user since v0.15.0. If you mount volumes or config files, ensure the files are readable by a non-root user.

See the Configuration page for details on connecting ThunderHub to your Lightning node via environment variables or a YAML config file.

Development

To run ThunderHub in development mode with hot reloading:


npm run start:dev

Breaking Changes in v0.15.0

For a full list of removed features and architectural updates, please read the v0.15.0 release notes .