CLN (Core Lightning) Node Setup — Common Errors and Fixes

Core Lightning (CLN) behaves differently from LND. Here are the most common setup errors and how to fix them.

1. Plugin not loading

# Check plugin status
lightning-cli plugin list

# If plugin shows 'failed':
cat ~/.lightning/bitcoin/lightningd.log | grep 'plugin'
# Look for: ImportError, ModuleNotFoundError, permission denied

2. Peer connection refused

# Test connectivity
lightning-cli connect PUBKEY@IP:PORT

# If fails:
# 1. Check that target node has announce-addr set
# 2. Check firewall: port 9735 must be open
# 3. Check Tor: if peer uses Tor, you need --proxy=127.0.0.1:9050

3. Channel stuck in CHANNELD_AWAITING_LOCKIN

lightning-cli listpeers | python3 -c "
import json,sys
for p in json.load(sys.stdin)['peers']:
    for ch in p.get('channels',[]):
        if 'AWAITING' in ch.get('state',''):
            print(ch['state'], ch['channel_id'][:16])
"

If stuck here >6 blocks: check that your funding transaction is confirmed on-chain (bitcoin-cli getrawtransaction TXID).

4. Invoice payment failing silently

lightning-cli paystatus BOLT11
# Shows full payment attempt history with failure reasons

Need help? $9 CLN/LND audit

Node health check, channel review, error diagnosis. USDT TRC-20.

→ Service page