Setup Guide
Pick your node platform below to follow a tailored, step-by-step setup playbook - from 1-click Node OS apps to bare-metal Linux WireGuard split-tunneling.
TunnelSats simplifies running a hybrid Lightning node by routing both inbound and outbound clearnet P2P traffic through a dedicated WireGuard VPN tunnel while keeping Tor connectivity active. You get low-latency clearnet routing, stronger peer uptime, and higher HTLC reliability without exposing your residential IP address.
Fast, low-latency HTLC routing and peer handshakes over IPv4 clearnet instead of multi-hop onion circuits.
Your residential IP remains hidden; peers only ever see your assigned static TunnelSats VPN endpoint.
Split-tunneling keeps Tor (.onion) active independently alongside clearnet, while fail-closed firewall rules block IP leaks if the VPN drops.
Dedicated Community Apps for Umbrel, StartOS 0.4, and myNode, a native RaspiBlitz SSH menu PR, and the unified tunnelsats.sh CLI for Bare-Metal Linux.
From anonymous Lightning subscription to dual-network Clearnet + Tor reachability
Always keep a backup of your WireGuard configuration file (tunnelsats_<server>.conf) and your Lightning node configuration. For privacy reasons, TunnelSats never stores your WireGuard PrivateKey and cannot recover lost config files.
What Node OS Are You Running?
Choose your system below to reveal only the exact install, config, and verification steps you need.
Dedicated Node OS Apps
RecommendedInstall through your node app store or 1-step community deployer - manage subscriptions, renewals, and health checks in a browser UI.
RaspiBlitz Native Integration (PR Pending)
Native SSH SUBSCRIBE menu awaiting upstream RaspiBlitz maintainer review, with full tunnelsats.sh CLI support available immediately today.
Bare-Metal Linux & Custom Nodes
Unified, auditable tunnelsats.sh CLI for RaspiBolt, MiniBolt, Debian, and Ubuntu with cgroup/nftables kill switches and full LND/CLN control.
Select one of the 5 node platforms above to open its step-by-step playbook.
Or click View All Platforms to inspect every installation, config, and verification track on one page.
Prerequisites & How to Subscribe
Software & Bare-Metal System Requirements
- LND:
0.14.2-betaminimum (0.18.4+strongly recommended to avoid an old gossip bug causing excessive bandwidth usage). - Core Lightning (CLN): Latest stable release (
v23.08+supported;26.6.8:3+on StartOS 0.4). - Eclair:
0.14.3:3+(supported natively on StartOS 0.4). - Port Allocation: One Lightning implementation per bare-metal host binds port
9735(on StartOS 0.4, each node runswg0inside its own isolated container with zero port conflicts). - Payment: Anonymous Bitcoin Lightning sats - no account, email, or KYC required.
- Debian or Ubuntu-based OS (
apt-getrequired) - Linux kernel
5.10.102+(verify withuname -r) nftables 0.9.6+(verify withnft -v)- LND or CLN running as a
systemdservice
Buying a Subscription on tunnelsats.com (5 Steps)
Using Umbrel, StartOS 0.4, or the myNode Community App? You can purchase your subscription directly inside the app UI on your node - or buy on tunnelsats.com first and import your .conf.
- 1Visit tunnelsats.com (or open your Node OS TunnelSats App).
- 2Select the VPN server region closest to your physical node for lowest routing latency.
- 3Choose your duration (
1,3,6, or12months - up to20%multi-month discount). - 4Pay the Lightning invoice with any wallet (or NWC).
- 5Save your
tunnelsats_<server>.conffile immediately to a secure backup.
Renewals, Server Consolidation & $1.00 Region Switch
In-Place Renewals & NWC
- 1.Open the Renew tab on tunnelsats.com or sign in to My Dashboard (via Nostr NIP-07 or
lncli signmessage). - 2.Enter your WireGuard Public Key (
# myPubKeyin your.confor viasudo wg show) and click Check Status. - 3.Choose your extension (
1,3,6, or12months - appended onto your current expiry date) and pay the Lightning invoice. Zero.confreplacement or node restart needed! - 4.Optional: Enable non-custodial Automatic NWC Renewals in My Dashboard, StartOS (Connect Wallet), or the myNode Community App.
$1.00 Zero-Downtime Region Switch
- Eligibility & Shared Quota: Available on all paid durations (
1,3,6,12months) while strictly more than 24 hours remain. Paid$1.00region switches and$1.00bandwidth resets share 2 slots per UTC calendar month across your subscription lineage (including open unpaid invoice reservations). - 72-Hour + 2,000 MB Parallel Grace & Fresh Bandwidth: Your exact
subscriptionEndcarries over unchanged and the destination peer starts with a fresh 100GB monthly cycle (unlimited stays unlimited). Your previous source peer remains live in parallel for up to 72 hours (3 days) and up to 2,000 MB (2 GB) of extra transfer so you can cut over with zero dropped HTLCs. - Why a Fresh
.confand New Port Are Issued: Each gateway runs independent IP/port tables and TunnelSats never stores or transfers WireGuardPrivateKeysecrets across servers. Switching regions always issues a brand-new.confand newly allocated forwarded TCP port (<newServer>:<newPort>).
If your node is on a retiring German server (de1.tunnelsats.com or de3.tunnelsats.com), enter your WireGuard Public Key in the Renew tab on tunnelsats.com and click Review Consolidation Offer to claim a free de2.tunnelsats.com replacement with 100% remaining time + 30 bonus days and a 7-day zero-downtime grace window (full migration details).
tunnelsats.sh CLI Command Reference
sudo bash tunnelsats.sh checkRead-only pre-check of kernel version, cgroup-tools, nftables, and systemd compatibility.
sudo bash tunnelsats.sh installInstalls dependencies (wireguard, cgroup-tools, nftables), configures split-tunneling and kill-switch rules, and enables systemd services.
sudo bash tunnelsats.sh statusRuns a comprehensive headless health check of WireGuard handshake, routing tables, Tor status, and public egress IP (or sudo tunnelsats verify on Managed Mode).
sudo bash tunnelsats.sh restartSafely stops your Lightning service, restarts the TunnelSats WireGuard tunnel, and restarts Lightning without risking home IP leaks.
sudo bash tunnelsats.sh uninstallRemoves all TunnelSats systemd units, nftables tables, cgroups, and WireGuard interfaces (add --managed for standalone Managed Mode setups).
Chat with our engineers on encrypted Armada (Nostr) or Telegram, or browse our searchable FAQ.