Skip to content

Commit ea80358

Browse files
committed
Add page on Lightning network error
1 parent 0f1a911 commit ea80358

File tree

2 files changed

+20
-0
lines changed

2 files changed

+20
-0
lines changed

docs/.vuepress/config.js

Lines changed: 1 addition & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -187,6 +187,7 @@ module.exports = {
187187
"/troubleshooting/drive-not-found",
188188
"/troubleshooting/bitcoin-error",
189189
"/troubleshooting/bitcoin-sync-slow",
190+
"/troubleshooting/lightning-network-error",
190191
"/troubleshooting/electrum-connection-error",
191192
"/troubleshooting/voltage-error",
192193
"/troubleshooting/sd-card-full-error",
Lines changed: 19 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -0,0 +1,19 @@
1+
# My Device has a Lightning Network Error
2+
3+
If your device gets into a state indicating "Network Error" as a Lightning Status, it means there has been a problem with Lightning launching and being able to properly connect to a network it can use for communication. This can typically be resolved quickly by changing the Lightning network to Tor-only on the main settings page.
4+
5+
## Check the Lightning Log
6+
7+
The first step is to track down the Lightning log on the status page and check it for errors. The lightning status may be rotating between various states because the process will restart automatically, but if you see a log line similar to the one below, that will confirm you are having Lightning network issues.
8+
9+
```
10+
Jan 12 14:57:21 mynode lnd[15786]: unable to create server: unable to discover a NAT-PMP enabled device on the local network
11+
```
12+
13+
This is caused by your network config being set to use Clearnet for Lightning. The Lightning daemon is attempting to communicate with your router to open a port and is failing. Disabling this setting will resolve the issue.
14+
15+
## Resolution
16+
17+
First, go to the main settings page on your node and scroll to the "Networking" section. In the row for Lightning, disable Clearnet and enable Tor. Save the config. Your device will reboot and Lightning should start as expected.
18+
19+
If you are still having issues, that setting may not have taken effect because of a [custom Lightning config](/advanced/customize-config.md). Reset your custom Lightning config back to the default so the network settings can take effect.

0 commit comments

Comments
 (0)