Setup Guide

Get your Lightning node onto clearnet in under 5 minutes. Our setup script auto-detects your platform and walks you through everything.

Your Platform
1

Subscribe & get your config

Subscribe here, pick a server, and pay with Lightning. Your WireGuard keys are generated automatically. After payment, you'll get a lnclear.conf file with everything you need.

# Your config includes your clearnet details:
# LNClear WireGuard Config
# Your clearnet IP: eu-central.lnclear.com
# Your Lightning port: 48000
# Connect your node to: eu-central.lnclear.com:48000
2

Copy files to your node

Copy your lnclear.conf and the setup script to your node:

# From your local machine
scp lnclear.conf lnclear.sh admin@your-node-ip:~/

# Or download the script directly on the node
wget -O lnclear.sh https://raw.githubusercontent.com/lnclear/lnclear-client/refs/heads/main/scripts/lnclear.sh
3

Run the setup script

Make sure your lnclear.conf is in the same directory, then run the script. It auto-detects your platform (Bare Metal), Lightning implementation (LND, CLN, or LiT), and configures everything:

sudo bash lnclear.sh

The interactive wizard will:

  • 1.Install WireGuard and set up the VPN tunnel
  • 2.Configure split-tunneling — only Lightning traffic goes through the VPN
  • 3.Update your Lightning config with the clearnet IP and port
  • 4.Restart Lightning and verify connectivity

Tor stays active the whole time. Your node will be briefly offline (~30 sec) during the Lightning restart.

4

Verify it's working

The script shows a success banner when done. You can also check anytime:

sudo bash lnclear.sh status

This checks your tunnel, outbound IP, Lightning port reachability, and announced addresses.

Other commands

sudo bash lnclear.sh restartSafely restart the tunnel (stops Lightning first to prevent IP leaks)
sudo bash lnclear.sh checkPre-flight compatibility check before installing
sudo bash lnclear.sh updateUpdate the script to the latest version
sudo bash lnclear.sh uninstallRemove tunnel, restore original Lightning config, back to Tor-only

Renewing your subscription

Before expiry, visit your dashboard and click Renew. Pay the invoice — your expiry extends automatically. No config changes or restart needed.

Still stuck? Check the FAQ →