The tunnelsats.sh script is the new, unified setup tool for TunnelSats v2. It consolidates all previous scripts (setupv2.sh, uninstallv2.sh, tunnelsats-sub-details.sh) into a single, robust interface.
Run the script with sudo and one of the following commands:
sudo bash tunnelsats.sh [install|uninstall|status|restart|pre-check]| Command | Description |
|---|---|
install |
Interactive wizard to install WireGuard, configure your node (LND/CLN/LIT), and set up networking. |
uninstall |
"Nuclear" uninstall. Removes all TunnelSats configurations, restores backups, and cleans up Docker networks/firewalls. |
status |
Detailed diagnostics. Checks subscription validity, interface status, Docker health, and connectivity (Ping/RTT). |
restart |
Smart restart helper. Re-initializes the WireGuard interface and DNS watchdog if you lose connection. |
pre-check |
Non-invasive verification. Checks if your system has the necessary prerequisites (WireGuard, Docker, etc.) without making changes. |
We are iteratively validating tunnelsats.sh across various Node OS platforms. Note that tunnelsats.sh is designed for systemd / bare-metal environments, whereas Umbrel uses a native containerized app package.
| Hardware/Platform | Node OS | OS Version | Host Script (tunnelsats.sh) |
Native App / Package |
|---|---|---|---|---|
| Raspberry Pi / PC | Umbrel | umbrelOS 1.0+ | N/A (Use Native App) | ✅ Native Umbrel App (Community Store / Official Review Pending) |
| Raspberry Pi | RaspiBlitz | v1.11.x | ✅ Supported | N/A |
| PC / VPS | Bare Metal | Debian 12 / Ubuntu | ✅ Supported | N/A |
| Pi / PC (x86) | myNode | v0.3.x | N/A | |
| Any Hardware | StartOS (Start9) | 0.3.5 & 0.4.0+ | ❌ Unsupported | ❌ Unsupported (LXC isolation prevents cross-package egress routing) |
Legend:
- ✅ Verified / Supported: Tested and working.
⚠️ Experimental: Logic exists, but needs live community verification.- N/A: Platform uses sandboxed container architecture — script execution bypassed in favor of native App Store packages.
Bare Metal / MiniBolt Note: We have explicitly verified the setup on MiniBolt (Ubuntu/Debian) environments. If following the MiniBolt guide, this script respects the standard directory structure and user permissions.
We want tunnelsats.sh to be rock-solid. If you are running on a platform marked as
- Running
sudo bash tunnelsats.sh statusand checking the output. - Reporting any "Stabilization Snags" in our Telegram Group.
- Providing your Hardware, Node OS, and OS Version (
cat /etc/os-release).
Your feedback directly translates into better stability for the entire community!
If you run into issues or have questions:
- Telegram Group: tunnelsats.com/join-telegram - Quickest way to get community help.
- Guide: guide.tunnelsats.com - Detailed manual setup instructions.
- Bot: t.me/TunnelSatsBot - Check your clearnet connection speed and tools.
If you encounter critical issues with tunnelsats.sh (v3.0), you can fall back to the proven v2 scripts located in the archive/ folder.
To use the legacy version:
cd archive
sudo bash setupv2.shThese scripts (setupv2.sh, uninstallv2.sh, etc.) are preserved for compatibility but will strictly be in maintenance mode. Please report any v3 issues so we can fix them!