Troubleshooting
In the event that you may run into issues with Lightning Terminal or one of its bundled products, you may refer to this page.
In case you are unable to connect to your node, especially after your browser having been idle for a while or recently having been restarted, you may:
- Attempt to reload the page asking for your password
- Click on “use a pairing phrase,” then reload the page and attempt again
- Delete the
session.dbin~/.lit/mainnet, restartlitdand generate a new pairing phrase - Delete the
admin.macaroonin~/.lnd/data/chain/bitcoin/mainnet/and restart LND and litd
In case you find yourself unable to connect to Pool due to a synchronization error, you may:
- Shut down
litdwithkill -s INT $(pidof litd) - Remove or rename your
pool.db - Run the Pool account recovery as below (NOTE that this will cancel any active orders. After recovering the account, the orders can be re-created manually).
You can generally find your
pool.db file in ~/.pool/mainnetIn Umbrel:
~/.pool/mainnet/In BTCPay Server:
/var/lib/docker/volumes/generated_lnd_lit_1/_data or /root/.pool/mainnetIn case Lightning Terminal has been improperly deleted or is otherwise corrupted, you may recover your funds using pool accounts recover.
Depending on your installation, you may need to call this command with additional arguments:
pool --tlscertpath ~/.lit/tls.cert --rpcserver=localhost:8443 accounts recoverUmbrel:
Find the docker process (lightning-terminal) with
docker ps
Open the pool container with docker exec -it 340a5b0839f1 /bin/bash
Recover the account: pool --tlscertpath "/data/.lit/tls.cert" --rpcserver localhost:8443 --macaroonpath "/data/.pool/mainnet/pool.macaroon" accounts recoverBTCPay:
cd btcpayserver-dockerpool
--rpcserver=localhost:8443 --macaroonpath /root/.pool/mainnet/pool.macaroon --tlscertpath /root/.lit/tls.cert accounts recover[ERR] LITD: Could not start subservers: unable to start account manager: unable to resume account X: unable to subscribe for account updates: checking pending batch failed: error removing pending batch artifacts: error abandoning channels from previous pending batch: error locating channel outpoint: no channel output found in batch tx for matched order YIf you are encountering the error above you will have to rename your
pool.db file and recover your account. In Umbrel you may follow these instructions:ssh [email protected]
cd ~/umbrel ./scripts/app
stop lightning-terminal
cd /umbrel/app-data/lightning-terminal/data/.pool/mainnet
mv pool.db pool.db.bak
cd /umbrel ./scripts/app
start lightning-terminal
docker exec -it lightning-terminal_web_1 bash
pool --rpcserver=localhost:8443 --tlscertpath=/.lit/tls.cert --macaroonpath=/.pool/mainnet/pool.macaroon accounts recoverLast modified 6mo ago