Interactive Setup Guide

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.

Clearnet Speed & Reliability

Fast, low-latency HTLC routing and peer handshakes over IPv4 clearnet instead of multi-hop onion circuits.

Full Egress & Ingress Privacy

Your residential IP remains hidden; peers only ever see your assigned static TunnelSats VPN endpoint.

Hybrid Redundancy & Kill Switch

Split-tunneling keeps Tor (.onion) active independently alongside clearnet, while fail-closed firewall rules block IP leaks if the VPN drops.

Platform-Native Workflows

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.

TunnelSats Sovereign Flow

From anonymous Lightning subscription to dual-network Clearnet + Tor reachability

STAGE 01Subscribe & Key CustodyPay in sats over Lightning0 KYC · Anonymous LN InvoiceLocal Curve25519 Keypair.conf Stays On Your Nodetunnelsats_<region>.confSTAGE 02Native App or Managed CLIAutomated split-tunnel setupNATIVE APPS & MANAGEDUmbrelStartOSmyNodeCLI & LINUX HOSTSRaspiBlitzBaremetal (tunnelsats.sh)wg-quick + cgroup splitSTAGE 03Hybrid Clearnet + TorDual-network Lightning P2PStatic Forwarded Port (9735)externalhosts / announce-addrtable 51820 nftables Kill SwitchHOME IP HIDDEN · TOR ACTIVE
STAGE 01Curve25519 keys are generated locally so TunnelSats never sees your WireGuard PrivateKey; pay anonymously over Lightning with zero KYC.
Back Up Your WireGuard Config Immediately

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.

Step 1 - Select Your Node System

What Node OS Are You Running?

Choose your system below to reveal only the exact install, config, and verification steps you need.

TIER 01

Dedicated Node OS Apps

Recommended

Install through your node app store or 1-step community deployer - manage subscriptions, renewals, and health checks in a browser UI.

TIER 02

RaspiBlitz Native Integration (PR Pending)

Native SSH SUBSCRIBE menu awaiting upstream RaspiBlitz maintainer review, with full tunnelsats.sh CLI support available immediately today.

TIER 03

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-beta minimum (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 runs wg0 inside its own isolated container with zero port conflicts).
  • Payment: Anonymous Bitcoin Lightning sats - no account, email, or KYC required.
Bare-Metal Linux Host Requirements
  • Debian or Ubuntu-based OS (apt-get required)
  • Linux kernel 5.10.102+ (verify with uname -r)
  • nftables 0.9.6+ (verify with nft -v)
  • LND or CLN running as a systemd service
Buying a Subscription on tunnelsats.com (5 Steps)
In-App Checkout Available

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.

  1. 1Visit tunnelsats.com (or open your Node OS TunnelSats App).
  2. 2Select the VPN server region closest to your physical node for lowest routing latency.
  3. 3Choose your duration (1, 3, 6, or 12 months - up to 20% multi-month discount).
  4. 4Pay the Lightning invoice with any wallet (or NWC).
  5. 5Save your tunnelsats_<server>.conf file immediately to a secure backup.

Renewals, Server Consolidation & $1.00 Region Switch

In-Place Renewals & NWC

  1. 1.Open the Renew tab on tunnelsats.com or sign in to My Dashboard (via Nostr NIP-07 or lncli signmessage).
  2. 2.Enter your WireGuard Public Key (# myPubKey in your .conf or via sudo wg show) and click Check Status.
  3. 3.Choose your extension (1, 3, 6, or 12 months - appended onto your current expiry date) and pay the Lightning invoice. Zero .conf replacement or node restart needed!
  4. 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, 12 months) while strictly more than 24 hours remain. Paid $1.00 region switches and $1.00 bandwidth 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 subscriptionEnd carries 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 .conf and New Port Are Issued: Each gateway runs independent IP/port tables and TunnelSats never stores or transfers WireGuard PrivateKey secrets across servers. Switching regions always issues a brand-new .conf and newly allocated forwarded TCP port (<newServer>:<newPort>).
Migrating from Phased-Out Servers (de1 / de3 to de2)

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 check

Read-only pre-check of kernel version, cgroup-tools, nftables, and systemd compatibility.

sudo bash tunnelsats.sh install

Installs dependencies (wireguard, cgroup-tools, nftables), configures split-tunneling and kill-switch rules, and enables systemd services.

sudo bash tunnelsats.sh status

Runs 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 restart

Safely stops your Lightning service, restarts the TunnelSats WireGuard tunnel, and restarts Lightning without risking home IP leaks.

sudo bash tunnelsats.sh uninstall

Removes all TunnelSats systemd units, nftables tables, cgroups, and WireGuard interfaces (add --managed for standalone Managed Mode setups).

Need Help With Your Node?

Chat with our engineers on encrypted Armada (Nostr) or Telegram, or browse our searchable FAQ.