ThunderHub

ThunderHub

Docker app from Raccommode's Repository

Overview

ThunderHub is an open-source Lightning Network node manager with a browser interface for monitoring and managing LND or Lightning Terminal nodes, channels, payments, on-chain wallet activity, Taproot Assets, swaps, and multi-node accounts.

Requirements

ThunderHub needs access to your LND or LiTD gRPC endpoint and credentials. By default this template stores account config in /data/thubConfig.yaml; edit that file under the Data path or configure the SSO variables. The Docker image runs as a non-root user, so mounted config, macaroon, and certificate files must be readable by the container.

Runtime arguments

Web UI
http://[IP]:[PORT:3000]
Network
bridge
Shell
sh
Privileged
false

Template configuration

Web UI PortPorttcp

Web interface port. Container port: 3000.

Target
3000
Default
3000
Value
3000
DataPathrw

Stores ThunderHub account config, optional cookie, and optional SQLite database files.

Target
/data
Default
/mnt/user/appdata/thunderhub
Value
/mnt/user/appdata/thunderhub
HostVariable

Interface ThunderHub listens on inside the container.

Target
HOST
Default
0.0.0.0
Value
0.0.0.0
Account Config PathVariable

Path to the ThunderHub YAML account config inside the container. ThunderHub can create this file if the Data path is writable.

Target
ACCOUNT_CONFIG_PATH
Default
/data/thubConfig.yaml
Value
/data/thubConfig.yaml
Master Password OverrideVariable

Optional password override used for all YAML accounts.

Target
MASTER_PASSWORD_OVERRIDE
Log LevelVariable

Logging level, for example error, warn, info, debug, or verbose.

Target
LOG_LEVEL
Default
info
Value
info
ThemeVariable

Default interface theme. Use dark or light.

Target
THEME
Default
dark
Value
dark
CurrencyVariable

Default currency display, for example sat, btc, or usd.

Target
CURRENCY
Default
sat
Value
sat
Mempool URLVariable

Mempool API base URL used for fee and block data.

Target
MEMPOOL_URL
Default
https://mempool.space
Value
https://mempool.space
Tor ProxyVariable

Optional SOCKS proxy used for outbound connections, for example socks://127.0.0.1:9050.

Target
TOR_PROXY_SERVER
Fetch PricesVariable

Fetch exchange price data. Set to false to disable.

Target
FETCH_PRICES
Default
true
Value
true
Fetch FeesVariable

Fetch fee recommendation data. Set to false to disable.

Target
FETCH_FEES
Default
true
Value
true
Disable External LinksVariable

Disable external links in the interface. Use true or false.

Target
DISABLE_LINKS
Default
false
Value
false
Disable Version CheckVariable

Disable checks against the latest GitHub release. Use true or false.

Target
NO_VERSION_CHECK
Default
false
Value
false
Disable All SubscriptionsVariable

Disable all Lightning realtime subscriptions. Use true or false.

Target
DISABLE_ALL_SUBS
Default
false
Value
false
LND DataPathro

Optional read-only mount for an LND data directory. YAML accounts can use lndDir: /lnd.

Target
/lnd
LiTD DataPathro

Optional read-only mount for a Lightning Terminal data directory. YAML accounts can use litDir: /lit.

Target
/lit
SSO Server URLVariable

Optional SSO node gRPC address, for example 192.168.1.10:10009 or lnd:10009.

Target
SSO_SERVER_URL
SSO Certificate PathVariable

Optional SSO TLS certificate path inside the container, for example /lnd/tls.cert.

Target
SSO_CERT_PATH
SSO Macaroon DirectoryVariable

Optional directory containing admin.macaroon for SSO, for example /lnd/data/chain/bitcoin/mainnet.

Target
SSO_MACAROON_PATH
SSO Node TypeVariable

SSO node type. Use lnd or litd.

Target
SSO_NODE_TYPE
Default
lnd
Value
lnd
Dangerous No SSO AuthVariable

Allow SSO without auth. Only use behind trusted access controls. Use true or false.

Target
DANGEROUS_NO_SSO_AUTH
Default
false
Value
false
Cookie PathVariable

Optional persistent cookie secret path. Keep this in the Data path if enabled.

Target
COOKIE_PATH
Default
/data/.cookie
Value
/data/.cookie
YAML Env 1Variable

Optional value that can be referenced from thubConfig.yaml as {YML_ENV_1}.

Target
YML_ENV_1
YAML Env 2Variable

Optional value that can be referenced from thubConfig.yaml as {YML_ENV_2}.

Target
YML_ENV_2
YAML Env 3Variable

Optional secret value that can be referenced from thubConfig.yaml as {YML_ENV_3}.

Target
YML_ENV_3
YAML Env 4Variable

Optional value that can be referenced from thubConfig.yaml as {YML_ENV_4}.

Target
YML_ENV_4
Database TypeVariable

Optional database backend. Leave blank to disable, or use sqlite or postgres.

Target
DB_TYPE
SQLite Database PathVariable

SQLite database path used when Database Type is sqlite.

Target
DB_SQLITE_PATH
Default
/data/thunderhub.db
Value
/data/thunderhub.db
Postgres URLVariable

Postgres connection URL used when Database Type is postgres.

Target
DB_POSTGRES_URL
Database Encryption KeyVariable

Optional 64-character hex key for encrypting node credentials at rest.

Target
DB_ENCRYPTION_KEY

Details

Repository
apotdevin/thunderhub:latest
Last Updated2026-06-01
First Seen2026-05-16

Run ThunderHub on Unraid.

ThunderHub is listed in Community Apps for Unraid OS. Explore Unraid to build a flexible home server, NAS, or homelab.