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.
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.
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.
Compare Speed & Reliability, Low Cost, and Privacy across node connectivity models
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.
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.
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):
Tor-Only bottleneck vs independent Clearnet WireGuard + Tor dual-network redundancy
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.
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.
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.
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.
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.
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.234becomes1.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.
.conf ImmediatelyBecause 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.
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).
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:
| Duration | Discount | Total Price (USD Equivalent) |
|---|---|---|
| 1 month | 0% | $3.00 |
| 3 months | 5% off | $8.55 |
| 6 months | 10% off | $16.20 |
| 12 months | 20% 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).
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:
- 1Open My Dashboard on tunnelsats.com (or use Reset Bandwidth inside the StartOS 0.4 or myNode Community App).
- 2Click Reset bandwidth ($1) on your subscription (available at any usage level; a "High bandwidth usage" warning appears starting at 70%).
- 3Paying the
$1.00invoice resets your current month's usage counter back to0immediately 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).
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.
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:
- 1Manual Web Renewal: Open the Renew tab on tunnelsats.com (or sign in to My Dashboard), enter your WireGuard public key (
# myPubKeyin your.confor viasudo wg show), select1,3,6, or12months, and pay the Lightning invoice. - 2Automatic 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.
- 3In-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
.onionrelay support). - 4Nostr 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.
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.00Lineage Quota: Paid$1.00region switches and$1.00bandwidth 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
.confand 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):
- 1Umbrel (
umbrelOS 1.0+): Open TunnelSats -> Subscribe / Import and paste the new.conf. In default Secure Mode (SECURE_MODE=true), manually updateexternalhosts=<newServer>:<newPort>inlnd.conf(orannounce-addrin CLNconfig) and restart your Lightning app. Only self-hosted Community Store setups withSECURE_MODE=falseupdate and restart automatically. - 2StartOS 0.4: Open Services -> TunnelSats -> Actions -> Import Subscription, choose your target node, paste the new
.conf, and approve theclearnet-vpnImportant Task. - 3myNode Community App (
ts-mynode): Openhttps://mynode.local:8740, click Backup .conf, import the new.conf, and click Apply (Mode A updates/mnt/hdd/mynode/settings/lnd_extra_config.confand restarts LND automatically; standalone Managed CLI users re-runtunnelsats.sh install --managed mynode --impl lnd --config tunnelsatsv2.confand update LND -> Config -> Additional LND Config). - 4RaspiBlitz: Copy the new
.conf, runsudo bash tunnelsats.sh install, updateexternalhosts=<newServer>:<newPort>in/mnt/hdd/lnd/lnd.conf(orannounce-addrin/mnt/hdd/app-data/.lightning/configfor CLN), and restart LND or CLN. - 5Bare-Metal Linux / RaspiBolt: Run
sudo bash tunnelsats.sh install, updateexternalhosts=<newServer>:<newPort>(lnd.conf) orannounce-addr=<newServer>:<newPort>(CLNconfig), and restart your daemon. LND nodes withpeersrpccan also broadcast immediately vialncli peers updatenodeannouncement --address_remove='<oldServer>:<oldPort>' --address_add='<newServer>:<newPort>'. - 6Relink Tunnel-Bot & Verify: Send
/link <newWgPublicKey>via encrypted DM to the TunnelSats Bot on Armada (migrated old keys automatically reportstatus: "disabled"withmigrated_to_server_domainso 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.
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).
- 1Open the Renew tab on tunnelsats.com, enter your current WireGuard Public Key, and click Check Status.
- 2Click Review Consolidation Offer to carry over 100% of your remaining subscription time plus +30 bonus days.
- 3Enter the PrivateKey from the
[Interface]section of your existingtunnelsats.conf(orwg0.conf) to cryptographically prove ownership, then click Accept Offer & Get New Config. - 4Download your new
de2.tunnelsats.comconfig and note your new forwarding port. - 5Install the new configuration and update
externalhosts=de2.tunnelsats.com:<newPort>(LND) orannounce-addr=de2.tunnelsats.com:<newPort>(CLN).
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.
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):
- Tier 1 - Dedicated Node OS Apps: Umbrel (
umbrelOS 1.0 - 1.5+) viaTunnelsats/ts-umbrel-app(Umbrel Guide), StartOS (v0.4.0+) for LND, CLN, and Eclair viaTunnelsats/tunnelsats-startos(StartOS Guide), and myNode (v0.3+/ Debian 12, LND) via our dedicated Community AppTunnelsats/ts-mynode(myNode Guide). - Tier 2 - RaspiBlitz (
v1.8.0+/v1.12Native PR): Native SSHSUBSCRIBEmenu pending upstream maintainer review (Tunnelsats/raspiblitz, PR#5324), with fulltunnelsats.shCLI support for LND and CLN available today (RaspiBlitz Guide). - Tier 3 - Bare-Metal Linux / RaspiBolt / MiniBolt: Debian/Ubuntu (
kernel 5.10.102+,nftables 0.9.6+,systemd) for LND and CLN viatunnelsats.sh(Bare-Metal 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.
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.
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.confOn 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.
RaspiBlitz: /mnt/hdd/app-data/.lightning/config
RaspiBolt: /data/cln/config
Umbrel 0.5+: /home/umbrel/umbrel/app-data/core-lightning/data/lightningd/bitcoin/configtunnelsats_<server>.conf & Finding Lost ConfigsOn 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.
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-appunder App Store -> More (...) -> Community App Stores, install TunnelSats, purchase or import your.confunder Subscribe / Import, and connect LND or CLN in the Installation tab. - How Umbrel Secure Mode Works: By default, the bundled Umbrel
docker-compose.ymlruns 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 setSECURE_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
tunnelsats.sh on Umbrel (SHA-256 Verified Uninstaller)- 1Recover your active config if needed:BASH
sudo awk '1;/PersistentKeepalive/{exit}' /etc/wireguard/tunnelsatsv2.conf - 2On
umbrelOS 1.6+, a simple reboot clears legacy host-level services. OnumbrelOS 1.0 - 1.5, run the SHA-256-verified legacy uninstaller pinned at commite281584:BASHcurl -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 - 3Install 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.
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 upwg0inside the node container with zero port9735conflicts. - Kill Switch & Lifecycle: Supported node packages enforce IPv4 and IPv6
blackholedefault routes in table51820inside the Lightning container so clearnet traffic drops ifwg0goes 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.
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.confwith local X25519 key custody, configure NWC auto-renewal, trigger$1.00bandwidth resets, and download backups with 1-click Backup .conf. - Reboot-Proof Privilege Separation: Unprivileged
bridge.pywrites atomic0600configs while the root reconciler (/usr/local/sbin/tunnelsats-reconcile) armstunnelsats.slice(cgroup v2),nftableskill switch, and/mnt/hdd/mynode/settings/lnd_extra_config.conf(selectinglnd.servicecleanly even whenlit.serviceis active; Core Lightning is N/A on myNode). - Mode B / Standalone CLI: Operators who prefer manual SSH execution can toggle
SECURE_MODE=trueor use standalonetunnelsats.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.
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.
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.
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:
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;
}
}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.
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:
[Interface]
PrivateKey = <YOUR_PRIVATE_KEY>
Address = <YOUR_IP>
Table = off
[Peer]
PublicKey = <PEER_PUBLIC_KEY>
Endpoint = <PEER_ENDPOINT>
AllowedIPs = 0.0.0.0/0Q.How should I tune Tor alongside TunnelSats?
Append LongLivedPorts and EntryGuard settings to torrc for steadier .onion circuits.
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:
LongLivedPorts 21,22,706,1863,5050,5190,5222,5223,6523,6667,6697,8300,9735,9736,9911
UseEntryGuards 1
NumEntryGuards 86. 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).
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):
# 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 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 statuswg 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 IPv62. 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:
nc -zv de2.tunnelsats.com 32320Q.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.
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:
- Armada Nostr Community (Recommended): Join TunnelSats on Armada for encrypted channels, NIP-17 DMs, and interactive bot diagnostics (
nostr:npub1n9z4y3xjramqes8fp9rl96x5e4nl0hff57ynw7vqnjpq370tq78sljsp8y). - Telegram Community: Join Tunnelā”Sats on Telegram.
- GitHub Issues: Open an issue on GitHub.
- Email & X: Contact
[email protected]or @TunnelSats on X.
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.
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.
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.
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
GET /api/public/v1/servers- List available VPN servers - 2
POST /api/public/v1/subscription/create- Request a BOLT11 Lightning invoice - 3Pay the invoice with any Lightning wallet
- 4
POST /api/public/v1/subscription/claim- Claim the provisioned WireGuard configuration - 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 (> 24hremaining) to a new region for$1.00using a sovereign X25519 proof orBearer/NostrNIP-98 credentials
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).