tunnelsats
TunnelSats: Hybrid Lightning Node Setup
Privacy-focused VPN tunnels for Lightning nodes. Run your node hybrid (clearnet + Tor) without exposing your home IP.
⚡ Quick Start
New to TunnelSats? Get up and running in 3 steps:
- Subscribe at tunnelsats.com and download your WireGuard config
- Run the installer on your node:
wget -O tunnelsats.sh https://github.com/tunnelsats/tunnelsats/raw/main/scripts/tunnelsats.sh sudo bash tunnelsats.sh install - Configure your node with the VPN settings from the installer output
👉 See full installation guide and compatibility matrix →
Why Hybrid Mode?
The Lightning Network needs fast, reliable, discoverable nodes for efficient routing. While Tor provides privacy, it can be slow and unreliable. TunnelSats solves this by:
- ⚡ Clearnet Speed – Direct connections for faster routing
- 🔒 VPN Privacy – Your home IP stays hidden
- 🧅 Tor Fallback – Maintains .onion connectivity
- 🛡️ Split Tunneling – Only Lightning traffic goes through VPN
Supported Platforms
| Platform | LND | CLN | Status |
|---|---|---|---|
| Umbrel (umbrelOS 1.5+) | ✅ | ✅ | Verified |
| RaspiBlitz (v1.11+) | ✅ | ✅ | Verified |
| Bare Metal (Debian/Ubuntu) | ✅ | ✅ | Verified |
| myNode (v0.3+) | ⚠️ | ⚠️ | Experimental |
| Start9 | ❌ | ❌ | Not Supported |
See scripts/README.md for detailed compatibility info.
Subscription & Renewal
New Subscription
- Visit tunnelsats.com
- Select a server location close to you
- Choose duration (1-12 months)
- Pay the Lightning invoice
- Download your WireGuard config
Renewal
- Web: tunnelsats.com → Renew Subscription
- Dashboard: Log in → My Dashboard → Renew
- API: api.tunnelsats.com
Your existing configuration remains valid after renewal – no changes needed!
Uninstallation
To remove TunnelSats and restore your original configuration:
sudo bash tunnelsats.sh uninstall
Support
- 💬 Telegram: Tunnel⚡Sats Group
- 📖 Guide: tunnelsats.com/guide
- ❓ FAQ: tunnelsats.com/faq
- 🐛 Issues: GitHub Issues
Credits
Built with ⚡ by @ziggie1984, @TrezorHannes, and @blckbx.
Special thanks to @LightRider5 (lnvpn.net) for inspiration and support.