Knowledge Base

Frequently Asked Questions

Searchable answers on Hybrid Mode architecture, zero-log privacy, pricing, 100GB bandwidth resets, $1.00 region switches, Node OS apps, and advanced networking.

1. Overview & Value Proposition

Why Hybrid Clearnet + Tor matters for Lightning routing performance and privacy.

Q.

Why should I use this service?

Combine low-latency clearnet HTLC routing with hidden residential IP privacy and Tor redundancy.

Providing Lightning ⚔ Services requires privacy, reliability, connectivity, speed, and liquidity. Relying on Tor alone for node connectivity poses risks to network stability, payment latency, and HTLC reliability.

With Hybrid connectivity, your payment and routing services are significantly faster and more reliable. However, exposing your residential clearnet IP reveals your physical location and opens your home network to potential DDoS or targeted attacks.

Tunnel⚔Sats offers the best of both worlds: your node and home IP remain hidden while our dedicated VPS public IP acts as your node's clearnet endpoint. This setup delivers higher reliability, improved uptime, fewer offline peers, and stronger routing performance.

Q.

Why choose Tunnel⚔Sats over other VPN providers?

Purpose-built for Lightning routing: static IP, dedicated forwarded port 9735, PSK WireGuard, and independent Tor split-tunnel.

Running a Lightning node behind a VPN requires features that general consumer VPN providers do not offer. Tunnel⚔Sats is purpose-built for Lightning routing nodes:

  • Anonymous Payment: Pay via Bitcoin Lightning (no KYC, no account name, and we do not know the sender).
  • Static VPN IP: No disconnects due to rotating consumer VPN IPs and no Dynamic DNS setup.
  • Dedicated Forwarded Port: Every subscription receives a dedicated TCP port mapped to your node (9735).
  • Quantum-Safe Tunnels: WireGuard tunnels hardened with pre-shared keys (PresharedKey).
  • Split-Tunneling & Redundancy: Only Lightning P2P traffic routes through the VPN. Unlike "Tor over VPN," Tor and clearnet operate independently: if Tor degrades, your clearnet VPN stays up, and if the VPN drops, Tor remains active while the kill switch blocks clearnet IP leaks.
Lightning Connectivity Trilemma

Compare Speed & Reliability, Low Cost, and Privacy across node connectivity models

SPEED & RELIABILITY12-42 ms clearnetLOW COSTZero VPS opsPRIVACYHidden Home IPClearnet OnlyHOME IP EXPOSED+ High speed & low cost- Reveals physical location- Home DDoS & port-forward opsTor Only~450-900 ms Ā· 6-HOP+ High privacy & built-in zero cost- High jitter, peer flaps & slower HTLCsHYBRID SWEET SPOTTunnelSats Hybrid VPN12-42 ms Ā· HIDDEN HOME IP+ Clearnet speed + Tor redundancy+ Static port & nftables kill switch+ Zero VPS ops Ā· anonymous sats
TunnelSats Hybrid VPNRECOMMENDED SWEET SPOT
Click or hover a triangle node to compare
Latency
12-42 ms (Clearnet)
Home IP Exposure
Hidden (Static VPN IP)
Uptime / HTLC Reliability
Dual-Network Hybrid + Tor
Setup Effort
Native App or Managed CLI

Routes Lightning clearnet P2P over encrypted WireGuard + PSK with a static forwarded port and nftables kill switch, while Tor stays independently active.

Q.

How do I know what value I get from subscribing?

Measure week-over-week peer latency, uptime, offline peer flaps, and HTLC forwarding success.

We recommend monitoring your peer latency, channel uptime, and routing volume week-over-week. Hybrid nodes typically observe faster peer handshakes, fewer offline peer flaps, and improved HTLC forwarding success compared to Tor-only nodes.

Q.

What does the connection setup look like?

Visual comparison of Tor-only routing vs. TunnelSats Hybrid Split-Tunnel + Kill Switch.

Below is an architectural comparison between a Tor-only node and the Tunnel⚔Sats hybrid split-tunnel setup (toggle Simulate VPN Drop to inspect how the fail-closed kill switch protects your home IP while Tor stays online):

Hybrid Split-Tunnel & Kill Switch Architecture

Tor-Only bottleneck vs independent Clearnet WireGuard + Tor dual-network redundancy

TOR-ONLY NODESINGLE NETWORKHome Lightning NodeLND / CLN Ā· Port 9735Home Router6-HOP TOR ONION CIRCUITH1H2H6~650 ms avg Ā· High JitterLightning Network (Tor Only)SINGLE-NETWORK BOTTLENECKSlow HTLCs Ā· Peer flaps Ā· No clearnetTUNNELSATS HYBRID SPLIT-TUNNELDUAL-NETWORK Ā· HOME IP HIDDENHome NodeLND / CLN / Eclaircgroup splittable 51820PATH A Ā· CLEARNET P2P (WG + PSK)table 51820 + nftablesnftables GateARMEDWG+PSKTunnelSats VPSde2.tunnelsats.com:port -> 9735ClearnetPeers12-42 msHOME IP 100% HIDDEN Ā· ENCRYPTED WIREGUARD TUNNELPATH B Ā· INDEPENDENT TOR (.ONION)BYPASSES VPNTor Onion CircuitSOCKS5 Ā· DirectNot "Tor over VPN"ACTIVETor .onion PeersSTAY CONNECTEDINDEPENDENT SPLIT-TUNNEL Ā· TRUE DUAL-NETWORK REDUNDANCY
HYBRID SPLIT-TUNNELClearnet Lightning P2P routes exclusively through the encrypted WireGuard + PSK tunnel (12-42 ms, home IP hidden), while Tor runs independently on its own path so neither network is a single point of failure.
Q.

What can be found in the "My Dashboard" section?

Manage expiry, real-time bandwidth gauges, NWC auto-renewal, $1 region switches, referrals, and API keys.

After signing in with your Nostr browser extension (e.g., Alby, nos2x) or by signing a challenge message with your Lightning node (lncli signmessage / lightning-cli signmessage), My Dashboard provides:

  • Subscription Details: Exact expiration timestamps, server endpoints, and real-time monthly bandwidth usage gauges.
  • Streamlined Renewals, Region Switches & Bandwidth Resets: One-click Lightning renewals, non-custodial NWC auto-renewal configuration, $1.00 region switches across active VPN gateways (with a 3-day / 2 GB parallel cutover grace window), and $1.00 monthly bandwidth counter resets.
  • Referral Program: Your unique referral link to earn free bonus months for both you and your friends.
  • API Key Management: Access to programmatic API keys and configuration details.
Q.

Do you offer full-service VPNs too?

No - TunnelSats specializes exclusively in Bitcoin Lightning node connectivity.

No. We specialize exclusively in Bitcoin Lightning node connectivity. For a general-purpose privacy VPN that accepts Lightning payments, check out LNVPN.net.

Q.

Who built this?

From Node Runners for Node Runners.

From Node Runners for Node Runners 🧔

2. Privacy, Trust & Security

Zero-log RAM-only WireGuard peer state, Tor Onion access, encrypted NWC storage, and infrastructure providers.

Q.

What services are used?

LNbits payments, multi-provider VPS gateways, WireGuard Manager API, and Upptime + Globalping telemetry.

  • Payment Backend: LNbits for Lightning invoice generation and settlement.
  • VPN Endpoints: Dedicated virtual servers across DigitalOcean (EU, Asia, NA), Hetzner (EU), and Vultr (LatAM).
  • Management: WireGuard Manager and API for hardened peer provisioning.
  • Monitoring: A dedicated instance of upptime paired with Globalping for worldwide latency telemetry.
Q.

What about data storage and privacy?

Zero packet logs, RAM-only peer endpoints, masked IP web logs, Onion site, and cryptographic key-only logins.

Website & Tor Access:

  • We use strictly essential session cookies for optional dashboard authentication only (zero third-party tracking or marketing cookies).
  • Web server logs anonymize IP addresses by zeroing out the lower octets (for example, 1.12.123.234 becomes 1.12.0.0).
  • For maximum anonymity, you can browse and subscribe via our Tor Onion service: http://tunnelpasz3fpxhuw6obb5tpuqkxmcmvqh7asx5vkqfwe7ix74ry22ad.onion

Anonymity-First Login & Accounts: Accounts are keyed solely by your cryptographic public key (Nostr npub via NIP-07 extension or Lightning node pubkey via lncli signmessage / lightning-cli signmessage). No email, password, or personal identity is required.

VPN Endpoints (Zero Packet Logs, RAM-Only Peer State):

  • We store only your WireGuard public key, pre-shared key, assigned port, expiration timestamp, and aggregate monthly byte counter.
  • We never inspect, capture, or log network packets from your node.
  • While a WireGuard tunnel is actively shaking hands, the Linux kernel holds the peer endpoint IP in volatile memory (RAM) to route return packets, and never writes it to disk.
Save Your .conf Immediately

Because TunnelSats does not store your WireGuard PrivateKey, we cannot reconstruct your tunnelsats_<server>.conf file if it is lost.

Payments & Encrypted Notifications: We only record the Lightning payment hash for accounting. Any email address or NWC (nostr+walletconnect://) URI configured in the Notifications / Automation dashboard tab is salted and encrypted using your session key - we cannot read or recover these credentials without your active session, and you can toggle Disable Notifications anytime to purge them.

Q.

Is your service reliable?

99.99% tier-1 data centers across independent providers, 24/7 alerting, live Status Page, and Warrant Canary.

We deploy on tier-1 data center providers with 99.99% uptime SLAs, distribute servers across multiple independent providers and continents, and monitor every gateway 24/7 with automated alerting covered by three operations engineers. Verify live health anytime on our Status Page and review our Warrant Canary.

3. Subscriptions, Pricing & Bandwidth

Multi-month discounts, 100GB allowance, $1.00 bandwidth resets, NWC auto-renewal, and $1.00 Region Switches.

Q.

Why are you charging fees? (Pricing & Discounts)

Starts at $3.00/mo in sats with automatic multi-month discounts up to 20% off ($28.80/year).

We incur continuous infrastructure costs for high-bandwidth, low-latency VPS gateways (even idle Lightning nodes exchange continuous gossip traffic) as well as engineering hours for security patching, OS package maintenance, and 24/7 monitoring.

Multi-month subscriptions receive automatic discounts across the website, Node OS apps, and Public API:

DurationDiscountTotal Price (USD Equivalent)
1 month0%$3.00
3 months5% off$8.55
6 months10% off$16.20
12 months20% off$28.80

Can I build my own VPS tunnel instead? Yes - we encourage learning! However, Tunnel⚔Sats provides a hardened, zero-maintenance service with multi-region servers, automated NWC renewals, native Umbrel/StartOS/myNode apps, and strict split-tunnel kill switches without the burden of managing your own cloud VPS and firewall rules.

Q.

Is there a data transfer limit (100GB / $1.00 Reset)?

100GB/month included; reset your counter to 0 anytime for $1.00 (shares 2/UTC-month quota with region switches).

Yes, each subscription includes 100GB per month, which is more than sufficient for the vast majority of routing nodes.

If you reach the 100GB monthly allowance, your VPN tunnel will be rate-limited/restricted until the next monthly cycle or until you perform a Bandwidth Reset:

  1. 1
    Open My Dashboard on tunnelsats.com (or use Reset Bandwidth inside the StartOS 0.4 or myNode Community App).
  2. 2
    Click Reset bandwidth ($1) on your subscription (available at any usage level; a "High bandwidth usage" warning appears starting at 70%).
  3. 3
    Paying the $1.00 invoice resets your current month's usage counter back to 0 immediately so your full 100GB allowance is available again (resets do not stack on top of remaining allowance, and share a combined quota of 2 paid bandwidth resets or region switches per UTC calendar month across your subscription lineage).
Keep LND Updated (v0.18.4+)

LND versions older than v0.18.4 had a known gossip bug causing excessive bandwidth consumption. Always keep your Lightning implementation updated.

Q.

How can I extend my subscription (Manual & Automatic NWC)?

Renew in-place with zero node restart via Web Renew, NWC auto-renewal, Node OS apps, or Armada DM alerts.

You can renew manually or automatically without replacing your .conf file or restarting your node:

  1. 1
    Manual Web Renewal: Open the Renew tab on tunnelsats.com (or sign in to My Dashboard), enter your WireGuard public key (# myPubKey in your .conf or via sudo wg show), select 1, 3, 6, or 12 months, and pay the Lightning invoice.
  2. 2
    Automatic NWC Renewals (Web Dashboard): Connect a Nostr Wallet Connect (NWC) URI in your Dashboard:
    • Duration & Discount Preservation: Auto-renewal renews for the same duration as your previous purchase (for example, a 12-month plan renews for another 12 months with the 20% discount).
    • Timing & Budget: Triggered 1-3 days before expiry. Set your wallet budget slightly above expected sats (~1.2x) to absorb BTC/USD price shifts.
  3. 3
    In-App Node OS Renewal (StartOS 0.4 & myNode Community App): Renew directly inside your node UI or connect a local NWC wallet (triggering 7 days before expiry with Tor .onion relay support).
  4. 4
    Nostr Bot Expiry Reminders: Link your WireGuard public key via encrypted DM to the TunnelSats Bot (/link <wgPublicKey>) on Armada to receive proactive DM alerts at 7, 3, and 1 days before expiry.
Q.

Can I switch my active subscription to another VPN server region ($1.00)?

Switch anytime (> 24h left) for $1.00 with preserved expiry, fresh 100GB cycle, and 72-hour / 2,000 MB parallel grace.

Yes! Any active paid subscription (across 1, 3, 6, or 12-month plans) with strictly more than 24 hours remaining can move to another offered TunnelSats server region for $1.00 USD (payable in sats over Lightning) via My Dashboard -> Switch Region ($1) or programmatically via the Public v1 API:

  • Preserved Subscription Time & Fresh Destination Cycle: Your exact subscriptionEnd, NWC auto-renewal setup, and referral link carry over unchanged, and your new destination tunnel starts with a fresh 100GB monthly bandwidth cycle (or preserves unlimited allowance).
  • Shared 2/UTC-Month $1.00 Lineage Quota: Paid $1.00 region switches and $1.00 bandwidth resets share 2 slots per UTC calendar month across your subscription lineage. Open unpaid invoices hold a slot until paid or confirmed expired.
  • 72-Hour + 2,000 MB Zero-Downtime Grace Window: Your previous tunnel stays active in parallel for up to 72 hours (3 days) (capped at original expiry) and up to 2,000 MB (2 GB) of extra traffic so you can update your node without dropping channels or HTLCs.
  • Fresh .conf and New Forwarded Port: Each WireGuard gateway manages an independent IP/port allocation table and TunnelSats never stores or transfers private keys between servers. Every region switch provisions a brand-new keypair (PrivateKey, PublicKey, PresharedKey) and a newly allocated forwarded TCP port (<newServer>:<newPort>).

Platform Cutover Summary (see the full Setup Guide: Switching Active VPN Server Regions for exact commands):

  1. 1
    Umbrel (umbrelOS 1.0+): Open TunnelSats -> Subscribe / Import and paste the new .conf. In default Secure Mode (SECURE_MODE=true), manually update externalhosts=<newServer>:<newPort> in lnd.conf (or announce-addr in CLN config) and restart your Lightning app. Only self-hosted Community Store setups with SECURE_MODE=false update and restart automatically.
  2. 2
    StartOS 0.4: Open Services -> TunnelSats -> Actions -> Import Subscription, choose your target node, paste the new .conf, and approve the clearnet-vpn Important Task.
  3. 3
    myNode Community App (ts-mynode): Open https://mynode.local:8740, click Backup .conf, import the new .conf, and click Apply (Mode A updates /mnt/hdd/mynode/settings/lnd_extra_config.conf and restarts LND automatically; standalone Managed CLI users re-run tunnelsats.sh install --managed mynode --impl lnd --config tunnelsatsv2.conf and update LND -> Config -> Additional LND Config).
  4. 4
    RaspiBlitz: Copy the new .conf, run sudo bash tunnelsats.sh install, update externalhosts=<newServer>:<newPort> in /mnt/hdd/lnd/lnd.conf (or announce-addr in /mnt/hdd/app-data/.lightning/config for CLN), and restart LND or CLN.
  5. 5
    Bare-Metal Linux / RaspiBolt: Run sudo bash tunnelsats.sh install, update externalhosts=<newServer>:<newPort> (lnd.conf) or announce-addr=<newServer>:<newPort> (CLN config), and restart your daemon. LND nodes with peersrpc can also broadcast immediately via lncli peers updatenodeannouncement --address_remove='<oldServer>:<oldPort>' --address_add='<newServer>:<newPort>'.
  6. 6
    Relink Tunnel-Bot & Verify: Send /link <newWgPublicKey> via encrypted DM to the TunnelSats Bot on Armada (migrated old keys automatically report status: "disabled" with migrated_to_server_domain so stale alerts stop), then verify inbound TCP and outbound VPN egress (Section 6).
Q.

How do I switch from phased-out servers (e.g. de1 / de3 to de2)?

Claim a free de2 replacement in the Renew tab with 100% remaining time, +30 bonus days, and 7-day grace.

We have consolidated our German VPN fleet onto our primary high-capacity de2.tunnelsats.com (Nuremberg) gateway and retired de1.tunnelsats.com and de3.tunnelsats.com (us1.tunnelsats.com was seamlessly merged into us3.tunnelsats.com at the DNS and peer layer).

  1. 1
    Open the Renew tab on tunnelsats.com, enter your current WireGuard Public Key, and click Check Status.
  2. 2
    Click Review Consolidation Offer to carry over 100% of your remaining subscription time plus +30 bonus days.
  3. 3
    Enter the PrivateKey from the [Interface] section of your existing tunnelsats.conf (or wg0.conf) to cryptographically prove ownership, then click Accept Offer & Get New Config.
  4. 4
    Download your new de2.tunnelsats.com config and note your new forwarding port.
  5. 5
    Install the new configuration and update externalhosts=de2.tunnelsats.com:<newPort> (LND) or announce-addr=de2.tunnelsats.com:<newPort> (CLN).
7-Day Zero-Downtime Grace Window

Accepting the consolidation offer does not immediately disable your legacy de1 or de3 tunnel. Your existing connection stays active for 7 days so you can switch at your convenience with zero downtime.

4. Platform & Setup Questions

Dedicated Apps for Umbrel, StartOS, and myNode, RaspiBlitz native PR, Bare-Metal Linux, and config paths.

Q.

Which node setups are supported?

Dedicated Apps for Umbrel, StartOS 0.4, and myNode; RaspiBlitz (native PR + CLI); and Bare-Metal Linux.

We organize supported platforms into three clean tracks (choose your node on our interactive Setup Guide):

For any other setup, reach out to our team on the Support Page.

Q.

Where do I find my Lightning configuration file (and transfer `.conf`)?

Exact file paths for LND and CLN across RaspiBlitz, RaspiBolt, Umbrel, and myNode, plus scp & find commands.

LND Configuration Paths (lnd.conf / lnd_extra_config.conf)
RaspiBlitz:  /mnt/hdd/lnd/lnd.conf
RaspiBolt:   /data/lnd/lnd.conf
Umbrel:      /home/umbrel/umbrel/lnd/lnd.conf
Umbrel 0.5+: /home/umbrel/umbrel/app-data/lightning/data/lnd/lnd.conf
myNode:      /mnt/hdd/mynode/settings/lnd_extra_config.conf
myNode Persistence Note

On myNode, lnd.service regenerates /mnt/hdd/mynode/lnd/lnd.conf on every restart via mynode_gen_lnd_config.sh. The myNode Community App (Tunnelsats/ts-mynode) manages /mnt/hdd/mynode/settings/lnd_extra_config.conf automatically; manual operators should edit LND -> Config -> Additional LND Config.

Core Lightning (CLN) Configuration Paths
RaspiBlitz:  /mnt/hdd/app-data/.lightning/config
RaspiBolt:   /data/cln/config
Umbrel 0.5+: /home/umbrel/umbrel/app-data/core-lightning/data/lightningd/bitcoin/config
Transferring tunnelsats_<server>.conf & Finding Lost Configs

On Umbrel, StartOS 0.4, and the myNode Community App, no scp transfer is needed - paste your .conf directly in the browser UI. On terminal nodes, run scp tunnelsats_<server>.conf [email protected]:/home/admin/. To locate configs over SSH, run sudo find / -name "lnd.conf" or sudo find / -maxdepth 5 -type d \( -path /etc/wireguard -o -path /sd-root \) -prune -o -type f -name "tunnelsats*.conf" -print.

Q.

How do I install, use Secure Mode, or migrate to the Umbrel App?

Add Tunnelsats/ts-umbrel-app Community Store, understand SECURE_MODE=true vs false, and migrate from legacy tunnelsats.sh.

The dedicated TunnelSats App for Umbrel replaces the legacy manual bash script and is available in the Umbrel Community App Store (https://github.com/Tunnelsats/ts-umbrel-app) while awaiting Official Umbrel App Store review (PR #4919). See the Umbrel Setup Guide for the full walkthrough.

  • New Users: Add https://github.com/Tunnelsats/ts-umbrel-app under App Store -> More (...) -> Community App Stores, install TunnelSats, purchase or import your .conf under Subscribe / Import, and connect LND or CLN in the Installation tab.
  • How Umbrel Secure Mode Works: By default, the bundled Umbrel docker-compose.yml runs in Secure Mode (SECURE_MODE=true, without root Docker socket access) on both Official Store and Community Store installs. The app displays exact target paths and copy-ready lines so you paste them via the Umbrel Files app or SSH and restart your Lightning app. Self-hosted Community App Store users can optionally set SECURE_MODE=false (with the Docker socket mount restored) for automated configuration and container restarts.
Migrating from Legacy tunnelsats.sh on Umbrel (SHA-256 Verified Uninstaller)
Legacy Upgrade
  1. 1
    Recover your active config if needed:
    BASH
    sudo awk '1;/PersistentKeepalive/{exit}' /etc/wireguard/tunnelsatsv2.conf
  2. 2
    On umbrelOS 1.6+, a simple reboot clears legacy host-level services. On umbrelOS 1.0 - 1.5, run the SHA-256-verified legacy uninstaller pinned at commit e281584:
    BASH
    curl -fsSL https://raw.githubusercontent.com/Tunnelsats/tunnelsats/e2815848bc11932daff0479af59f21e53503b95b/scripts/tunnelsats.sh -o /tmp/tunnelsats-legacy.sh
    echo "6ebcd135ab9b5c8da5374211a7d2dd8129536a1deaa5b04b83b22be0cb7fe2a5  /tmp/tunnelsats-legacy.sh" | sha256sum -c -
    sudo bash /tmp/tunnelsats-legacy.sh uninstall --keep-config
    rm -f /tmp/tunnelsats-legacy.sh
  3. 3
    Install the Umbrel App, paste your config into Subscribe / Import, and follow the Installation tab.
Q.

How do I configure TunnelSats on StartOS 0.4?

Install from Start9 Community Registry, Buy/Import subscription, and approve the 1-click clearnet-vpn task.

The native TunnelSats package for StartOS 0.4 (LND, Core Lightning, and Eclair) is available in the Start9 Community Registry (source: Tunnelsats/tunnelsats-startos, latest release). It requires LND 0.21.3-beta:10, Core Lightning 26.6.8:3, or Eclair 0.14.3:3 (or newer). See the StartOS Setup Guide.

  • How It Works: Buy or import your subscription in Services -> TunnelSats -> Actions (Buy Subscription generates your WireGuard keypair locally and raises a Pay Invoice task on your node; Import Subscription imports an existing .conf). Approve the 1-click clearnet-vpn task on your Lightning node to bring up wg0 inside the node container with zero port 9735 conflicts.
  • Kill Switch & Lifecycle: Supported node packages enforce IPv4 and IPv6 blackhole default routes in table 51820 inside the Lightning container so clearnet traffic drops if wg0 goes down while Tor peers stay connected. Always run Export WireGuard Configuration before uninstalling.
Q.

How does the dedicated myNode Community App work?

Deploy Tunnelsats/ts-mynode in 1 step for a full MyNode UI (:8740), reboot-safe LND reconciler, and NWC auto-renewal.

While our upstream mynodebtc/mynode marketplace submission completes review, myNode operators can deploy our dedicated Community App (Tunnelsats/ts-mynode) in one command (./scripts/deploy_mynode.sh <MYNODE_IP> admin). See the full myNode Setup Guide.

  • Full Browser UI (:8740): Browse server regions, purchase or import .conf with local X25519 key custody, configure NWC auto-renewal, trigger $1.00 bandwidth resets, and download backups with 1-click Backup .conf.
  • Reboot-Proof Privilege Separation: Unprivileged bridge.py writes atomic 0600 configs while the root reconciler (/usr/local/sbin/tunnelsats-reconcile) arms tunnelsats.slice (cgroup v2), nftables kill switch, and /mnt/hdd/mynode/settings/lnd_extra_config.conf (selecting lnd.service cleanly even when lit.service is active; Core Lightning is N/A on myNode).
  • Mode B / Standalone CLI: Operators who prefer manual SSH execution can toggle SECURE_MODE=true or use standalone tunnelsats.sh --managed mynode --impl lnd.
Q.

What is the status of native RaspiBlitz support?

Native SUBSCRIBE menu PR (#5324) is waiting on RaspiBlitz maintainers; stock RaspiBlitz works today via tunnelsats.sh.

We built a complete native RaspiBlitz integration (MAIN MENU -> SUBSCRIBE -> TUNNELSATS VPN, preview at Tunnelsats/raspiblitz, upstream PR raspiblitz/raspiblitz#5324) featuring SSH + 3.5" LCD QR invoices, direct NODE payment, tmpfs Tor-at-rest start guards, and SD-reflash auto-restore.

While we wait for RaspiBlitz maintainers to review and merge the PR, stock RaspiBlitz nodes (v1.8.0+) are fully supported today via tunnelsats.sh for both LND and Core Lightning - see the RaspiBlitz Setup Guide.

5. Advanced Networking (Tailscale, Mullvad, Tor)

Coexisting with Tailscale/ZeroTier, Mullvad nftables exclusions, secondary WireGuard tunnels, and Tor tuning.

Q.

Am I still able to connect to gRPC or REST via Tailscale / ZeroTier?

Yes - ports 10009 (gRPC) and 8080 (REST) are excluded from the split tunnel.

Yes. As of commit 24f0f3c, ports 10009 (gRPC) and 8080 (REST) are excluded from the TunnelSats split tunnel so you can connect to your node remotely via Tailscale or ZeroTier without interference.

Q.

Can I run TunnelSats v2 and Mullvad in parallel?

Yes - apply an nftables exclusion table so Mullvad does not hijack TunnelSats WireGuard packets.

Yes, by starting Mullvad before TunnelSats and adding an nftables exclusion table (exclude.rules) so Mullvad does not hijack TunnelSats packets:

exclude.rules (Apply with: sudo nft -f exclude.rules)
table inet excludeTraffic {
  chain allowIncoming {
    type filter hook input priority -100; policy accept;
    ip saddr <IP_OF_TUNNELSATS_VPN> ct mark set 0x00000f41 meta mark set 0x6d6f6c65
    iifname tunnelsatsv2 ct mark set 0x00000f41;
  }

  chain allowOutgoing {
    type route hook output priority -100; policy accept;
    ip daddr <IP_OF_TUNNELSATS_VPN> ct mark set 0x00000f41 meta mark set 0x6d6f6c65
    oifname tunnelsatsv2 ct mark set 0x00000f41;
  }
}
Replace <IP_OF_TUNNELSATS_VPN> with your assigned TunnelSats server IPv4 address, then run sudo nft -f exclude.rules.
Q.

Is it possible to run another WireGuard tunnel alongside TunnelSats?

Yes - use a separate subnet (not 10.9.0.0/24) and set Table = off in your second WireGuard config.

Yes. Create a separate WireGuard configuration file (e.g., myvpn.conf) using a different subnet (do not use 10.9.0.0/24) and set Table = off:

myvpn.conf (Start with: wg-quick up myvpn.conf)
[Interface]
PrivateKey = <YOUR_PRIVATE_KEY>
Address = <YOUR_IP>
Table = off

[Peer]
PublicKey = <PEER_PUBLIC_KEY>
Endpoint = <PEER_ENDPOINT>
AllowedIPs = 0.0.0.0/0
Q.

How should I tune Tor alongside TunnelSats?

Append LongLivedPorts and EntryGuard settings to torrc for steadier .onion circuits.

To improve Tor circuit stability alongside your clearnet VPN tunnel, append these settings to your torrc file:

torrc
LongLivedPorts 21,22,706,1863,5050,5190,5222,5223,6523,6667,6697,8300,9735,9736,9911
UseEntryGuards 1
NumEntryGuards 8

6. Verification & Troubleshooting

Prove outbound egress privacy, inbound port reachability, and get fast human support.

Q.

How do I verify the tunnel and my connection are working correctly?

Verify both outbound VPN egress IP (per platform) and inbound TCP port reachability (nc / Armada / Telegram bot).

1. Verify Outbound Egress Privacy (Confirm your node exits via the TunnelSats VPN IP, never your home IP):

Umbrel App (umbrelOS 1.0+)
# Community App Store installs (bundled host verifier):
sudo ~/umbrel/app-data/tunnelsats/scripts/verify.sh

# Direct outbound egress check via the tunnelsats-daemon container (all installs):
DAEMON_CID=$(sudo docker ps -q --filter "label=com.docker.compose.service=tunnelsats-daemon" | head -n 1)
sudo docker exec "$DAEMON_CID" curl -sL --interface tunnelsatsv2 https://api.ipify.org
myNode Community App, RaspiBlitz, RaspiBolt & Bare-Metal
# myNode Community App JSON verifier:
sudo /usr/local/sbin/tunnelsats verify --json

# Script-based cgroup egress probe (RaspiBlitz / RaspiBolt / Bare-Metal / Managed CLI):
cgexec -g net_cls:splitted_processes curl --silent https://api.ipify.org
sudo bash tunnelsats.sh status
StartOS 0.4 Native Package (inside start-cli package attach lnd)
wg show wg0                    # recent handshake and non-zero transfer
ip rule                        # rule with "lookup 51820"
ip route show table 51820      # "default dev wg0" and "blackhole default metric 4294967295"
ip -6 route show table 51820   # "blackhole default dev lo metric 4294967295"
curl -4 -s https://ifconfig.me # must print the TunnelSats server IPv4, not your home IP
curl -6 -s https://ifconfig.me # must fail or print VPN IPv6, never your home IPv6

2. Verify Inbound Connections (TCP Port Reachability & Bot Ping): Replace de2.tunnelsats.com and 32320 with your server and forwarded port, or run /ping <pubkey> on Armada / @TunnelSatsBot:

Inbound TCP Port Probe
nc -zv de2.tunnelsats.com 32320
Success output: Connection to de2.tunnelsats.com port 32320 [tcp/*] succeeded!
Q.

I'm stuck with the setup process - where can I get help?

Reach our engineers and community on Armada (Nostr), Telegram, GitHub Issues, Email, or X.

Yes! Visit our Support & Community Page for our diagnostic checklist and direct links to:

If you are ever unsatisfied or run into a blocker, contact us directly and we will find a solution for your setup.

7. Referral Program & Public API

Earn +1 to +3 free bonus months with referrals, or automate tunnels via Public REST API v1 & HTTP 402 (L402).

Q.

How does the Referral Program work?

Share your Dashboard link to earn +1M / +2M / +3M free bonus months for both you and your friend.

Generate your unique referral link in My Dashboard and share it with fellow node runners. When someone purchases a subscription using your referral link, both you and your friend receive free bonus time automatically once payment settles:

  • 3-month plan: +1 bonus month for your friend and +1 bonus month added to your active subscription
  • 6-month plan: +2 bonus months for each of you
  • 12-month plan: +3 bonus months for each of you
Q.

I referred a friend but didn't get my bonus?

Bonuses auto-credit to your active subscription upon invoice settlement.

Referral bonuses are credited automatically upon invoice settlement to your active subscription. If your own subscription had already expired long before the referral occurred, renew your subscription first or reach out via Support with your WireGuard public key.

Q.

How do I use the TunnelSats Public API & HTTP 402 (L402) Gateway?

Programmatic server discovery, Lightning invoices, client-held claims, $1 region switches, and agent-native L402.

Our Public API enables programmatic subscription creation, claiming, renewals, $1.00 bandwidth resets, and $1.00 region switches (/api/public/v1/subscription/migrate/*) - ideal for node OS integrations (Umbrel, StartOS, myNode, RaspiBlitz), AI agents, and multi-node fleet operators.

  1. 1
    GET /api/public/v1/servers - List available VPN servers
  2. 2
    POST /api/public/v1/subscription/create - Request a BOLT11 Lightning invoice
  3. 3
    Pay the invoice with any Lightning wallet
  4. 4
    POST /api/public/v1/subscription/claim - Claim the provisioned WireGuard configuration
  5. 5
    (Optional) POST /api/public/v1/subscription/migrate/check -> POST /api/public/v1/subscription/migrate -> POST /api/public/v1/subscription/migrate/claim - Switch an active subscription (> 24h remaining) to a new region for $1.00 using a sovereign X25519 proof or Bearer / Nostr NIP-98 credentials
Example - Create a 3-Month Subscription on eu-de
curl -X POST https://tunnelsats.com/api/public/v1/subscription/create \
  -H "Content-Type: application/json" \
  -d '{"serverId": "eu-de", "duration": 3}'

Explore the complete interactive OpenAPI specification, schemas, and code samples at api.tunnelsats.com (or fetch https://api.tunnelsats.com/llms.txt and https://tunnelsats.com/auth.md for AI agents).