Installation

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 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 .