Skip to content

Commit 9f7a773

Browse files
authored
docs: mark StartOS as unsupported in compatibility tables (#202)
StartOS 0.4.0 LXC subcontainer isolation architecture prevents cross-package egress encapsulation, making it impossible for a third-party package to route outbound peer node traffic through WireGuard without exposing residential IP.
1 parent d5e1b0f commit 9f7a773

2 files changed

Lines changed: 4 additions & 4 deletions

File tree

README.md

Lines changed: 2 additions & 2 deletions
Original file line numberDiff line numberDiff line change
@@ -38,14 +38,14 @@ The Lightning Network needs **fast, reliable, discoverable** nodes for efficient
3838
| Platform | Type | LND | CLN | Installation Method |
3939
|:---|:---|:---:|:---:|:---|
4040
| **Umbrel** (umbrelOS 1.0+) | Docker App ||| **Native Umbrel App** ([Community App Store](https://github.com/Tunnelsats/ts-umbrel-app) / Official Review Pending) |
41-
| **StartOS** (StartOS 0.3.5 & 0.4.0+) | Service Package ||| **Native `.s9pk` Package** ([tunnelsats-startos repo](https://github.com/Tunnelsats/tunnelsats-startos) / Official Store Pending) |
4241
| **RaspiBlitz** (v1.11+) | Systemd ||| Host Script (`tunnelsats.sh`) |
4342
| **Bare Metal** (Debian/Ubuntu) | Systemd ||| Host Script (`tunnelsats.sh`) |
4443
| **myNode** (v0.3+) | Systemd | ⚠️ | ⚠️ | Host Script (`tunnelsats.sh` - Experimental) |
44+
| **StartOS** (Start9) | Service Package |||**Unsupported** (LXC isolation prevents cross-package egress routing) |
4545

4646
> ℹ️ **Security Architecture Note**:
4747
> The `tunnelsats.sh` bash installer is designed for bare-metal / systemd nodes (RaspiBlitz, RaspiBolt, MiniBolt, myNode).
48-
> Due to the strict container sandboxing and security infrastructure of **Umbrel** and **StartOS**, manual host script execution is unsupported on those platforms — please use their respective native App / Service installations.
48+
> Due to container sandboxing, manual host script execution is unsupported on **Umbrel** — please use the native [Umbrel App](https://github.com/Tunnelsats/ts-umbrel-app) installation. StartOS is unsupported as its LXC architecture does not allow third-party packages to encapsulate peer node egress.
4949
5050
See [scripts/README.md](./scripts/) for detailed compatibility info.
5151

scripts/README.md

Lines changed: 2 additions & 2 deletions
Original file line numberDiff line numberDiff line change
@@ -22,15 +22,15 @@ sudo bash tunnelsats.sh [install|uninstall|status|restart|pre-check]
2222

2323
## Compatibility & Testing Status
2424

25-
We are iteratively validating `tunnelsats.sh` across various Node OS platforms. Note that `tunnelsats.sh` is designed for systemd / bare-metal environments, whereas **Umbrel** and **StartOS** use native containerized app packages.
25+
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.
2626

2727
| Hardware/Platform | Node OS | OS Version | Host Script (`tunnelsats.sh`) | Native App / Package |
2828
| :--- | :--- | :--- | :---: | :---: |
2929
| Raspberry Pi / PC | **Umbrel** | umbrelOS 1.0+ | N/A (Use Native App) | ✅ Native Umbrel App (Community Store / Official Review Pending) |
30-
| Any Hardware | **StartOS (Start9)** | 0.3.5 & 0.4.0+ | N/A (Use Native Package) | ✅ Native `.s9pk` Package (Sideload / Official Store Pending) |
3130
| Raspberry Pi | **RaspiBlitz** | v1.11.x | ✅ Supported | N/A |
3231
| PC / VPS | **Bare Metal** | Debian 12 / Ubuntu | ✅ Supported | N/A |
3332
| Pi / PC (x86) | **myNode** | v0.3.x | ⚠️ Experimental | N/A |
33+
| Any Hardware | **StartOS (Start9)** | 0.3.5 & 0.4.0+ | ❌ Unsupported | ❌ Unsupported (LXC isolation prevents cross-package egress routing) |
3434

3535
**Legend:**
3636
-**Verified / Supported**: Tested and working.

0 commit comments

Comments
 (0)