Lightning Terminal

Lightning Terminal (opens new window) (LiT) is a browser-based interface for managing channel liquidity. It integrates the Lightning Labs services Loop, Poold and Faraday all in one and offers a web UI to manage them. This fragment requires Bitcoin LND. It selects that dependency automatically.

Installation

This requires an existing BTCPay Server Docker deployment and must be run from a root login shell. The fragment selects Bitcoin LND automatically.

Important: Lightning Terminal receives LND's administrative macaroon and can control funds and channels; it is not a read-only dashboard. Its UI and RPC endpoints are routed through the public BTCPay hostname. Protect the generated UI password and consider an additional access-control layer.

The fragment enables LiT's automatic bbolt-to-SQL migration. Once that migration completes, its data cannot be downgraded to a pre-0.17 LiT release or migrated back to bbolt. Ensure the deployment and lnd_lit_datadir data are recoverable before enabling or updating the fragment, and review the pinned LiT release's migration notes.

Enable the fragment:

btcpay-fragments add opt-add-lightning-terminal

Setup generates a 64-character UI password once, stores it in secrets/lit_password, and mounts it into the container as a Compose secret. Display the password from a root login shell with:

cat "$BTCPAY_BASE_DIRECTORY/btcpayserver-docker/secrets/lit_password"

Treat the secret file and Docker access as privileged. To rotate the password, replace the file contents with a new password of at least eight characters and restart the lnd_lit service.

Lightning Terminal appears under Server Settings > Services and is served at /lit/ on the BTCPay Server host.

Troubleshooting

To see the logs of the Lightning Terminal service, you can run this command:

docker-compose -f "$BTCPAY_DOCKER_COMPOSE" logs -f lnd_lit