# Troubleshooting

Unable to find what you are looking for? Contact the team on [Slack](https://lightning.engineering/slack.html) for help!

## Unable to connect <a href="#docs-internal-guid-d0ac868a-7fff-0e26-52e4-c5cfe3f7199e" id="docs-internal-guid-d0ac868a-7fff-0e26-52e4-c5cfe3f7199e"></a>

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
* [Generate a new pairing phrase](/lightning-network-tools/lightning-terminal/connect.md#connect-to-lightning-terminal), delete the browser cache, reload the page and connect again
* Delete the `session.db` in `~/.lit/mainnet`, restart `litd` and generate a new pairing phrase
* Delete the `admin.macaroon` in `~/.lnd/data/chain/bitcoin/mainnet/` and restart LND and litd

## Pool account is not synced

In case you find yourself unable to connect to Pool due to a synchronization error, you may:

* Shut down `litd` with `kill -s INT $(pidof litd)`
* Remove or rename your `pool.db`
* [Start](/lightning-network-tools/lightning-terminal/get-lit.md#docs-internal-guid-ae172929-7fff-f9d0-7921-e6f8acc92f53) `litd`
* 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/mainnet`

In Umbrel: `~/.pool/mainnet/`

In BTCPay Server: `/var/lib/docker/volumes/generated_lnd_lit_1/_data` or `/root/.pool/mainnet`

## Pool account recovery

In 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 recover`

**Umbrel**:\
Find the docker process (lightning-terminal) with `docker ps`\
Open the pool container with `docker exec -it 340a5b0839f1 /bin/bash`\
Recover the account:\
`pool --rpcserver=localhost:8443 --tlscertpath=/.lit/tls.cert --macaroonpath=/.pool/mainnet/pool.macaroon accounts recover`

**BTCPay**:\
\
`cd btcpayserver-docker`

pool `--rpcserver=localhost:8443 --macaroonpath /root/.pool/mainnet/pool.macaroon --tlscertpath /root/.lit/tls.cert accounts recover`

[Read more about Pool Accounts Recovery](/lightning-network-tools/pool/account_recovery.md)

## Pool is unable to resume account

`[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 Y`

If 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 umbrel@umbrel.local`\
`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 recover`


---

# Agent Instructions: Querying This Documentation

If you need additional information that is not directly available in this page, you can query the documentation dynamically by asking a question.

Perform an HTTP GET request on the current page URL with the `ask` query parameter:

```
GET https://docs.lightning.engineering/lightning-network-tools/lightning-terminal/troubleshooting.md?ask=<question>
```

The question should be specific, self-contained, and written in natural language.
The response will contain a direct answer to the question and relevant excerpts and sources from the documentation.

Use this mechanism when the answer is not explicitly present in the current page, you need clarification or additional context, or you want to retrieve related documentation sections.
