From c8ec215a4a8bef0673082397eef7e54b8476d794 Mon Sep 17 00:00:00 2001 From: Bernt Christian Egeland Date: Sun, 29 Dec 2024 08:31:27 +0000 Subject: [PATCH 1/4] added info for mobile limitation --- docs/docs/Usage/private_root.md | 35 +++++++++++++++++++++++++++++++++ 1 file changed, 35 insertions(+) diff --git a/docs/docs/Usage/private_root.md b/docs/docs/Usage/private_root.md index 5a644601..b4e1163f 100644 --- a/docs/docs/Usage/private_root.md +++ b/docs/docs/Usage/private_root.md @@ -7,6 +7,9 @@ description: Learn how to create and manage private root servers with ZTNet. # Managing Private Root Servers with ZTNet +> **Important Note Before You Begin**: When using a custom planet setup, please be aware that mobile platforms (Android and iOS) have significant limitations. The official mobile apps do not currently support custom planet configurations, and workarounds require additional technical steps. Please review the [Mobile Platform Limitations](#mobile-platform-limitations) section below before proceeding with your setup. + + ### What is a Private Root Server? A private root server in ZeroTier acts as a central coordination point for a ZeroTier network. Unlike [public root servers](https://zerotier.atlassian.net/wiki/spaces/SD/pages/7241732/Root+Server+IP+Addresses) provided by ZeroTier, private root servers are self-hosted and managed by the network administrator. They play a crucial role in network management, node authentication, and route orchestration. @@ -109,6 +112,38 @@ To connect your devices to the newly established private root server, they need By implementing these steps, your network devices will use your private root server, ensuring that they are no longer connected to the public ZeroTier root servers. Confirm the success of your setup by checking that devices can communicate with each other through the private root and that the public root servers no longer appear in the peer list. +## Mobile Platform Limitations + +When setting up devices with a custom planet configuration, it's important to note that mobile platforms have significant limitations compared to desktop systems. While this might be implemented in the official apps in the future, there is currently no ETA set. + +### Android Limitations and Workarounds + +The official ZeroTier Android app does not support direct custom planet configuration. There are several workarounds available: + +1. **ZeroTierFix** (github.com/kaaass/ZerotierFix): + - An unofficial modified version of the ZeroTier app that supports custom planets + - Currently one of the most straightforward solutions for non-rooted devices + - Note: This is a third-party modification of the official app + +2. **Magisk Module** (github.com/eventlOwOp/zerotier-magisk): + - Allows manual replacement of the planet file at `/data/adb/zerotier/home/planet` + - Note: This is a third-party modification of the official app + +### iOS Limitations and Workarounds + +iOS has similar limitations with the official app. Currently known workarounds: + +1. **ZeroTieriOSFix** (github.com/lemon4ex/ZeroTieriOSFix): + - Requires compiling and signing a modified version of the app + - Need access to Apple Developer tools and signing capabilities + - May require renewal of certificates periodically + +### Important Considerations + +- These limitations should be carefully considered before committing to a private root setup +- Mobile workarounds may require technical expertise to implement +- Third-party modifications come with their own security considerations +- Future updates to official apps may affect the availability or functionality of these workarounds ## Adding a Second Private Root Server in ZeroTier To add a second private root server to your ZeroTier network, follow these steps: From bcd62e1084fe2dff38e7f5b2d51ee6e8e9589d46 Mon Sep 17 00:00:00 2001 From: Bernt Christian Egeland Date: Sun, 29 Dec 2024 08:34:40 +0000 Subject: [PATCH 2/4] title --- docs/docs/Usage/private_root.md | 2 +- 1 file changed, 1 insertion(+), 1 deletion(-) diff --git a/docs/docs/Usage/private_root.md b/docs/docs/Usage/private_root.md index b4e1163f..06ea6209 100644 --- a/docs/docs/Usage/private_root.md +++ b/docs/docs/Usage/private_root.md @@ -125,7 +125,7 @@ The official ZeroTier Android app does not support direct custom planet configur - Currently one of the most straightforward solutions for non-rooted devices - Note: This is a third-party modification of the official app -2. **Magisk Module** (github.com/eventlOwOp/zerotier-magisk): +2. **Zerotier-Magisk** (github.com/eventlOwOp/zerotier-magisk): - Allows manual replacement of the planet file at `/data/adb/zerotier/home/planet` - Note: This is a third-party modification of the official app From 7061c45491a96faa4093f0d570f16e47b312e3b4 Mon Sep 17 00:00:00 2001 From: Bernt Christian Egeland Date: Sun, 29 Dec 2024 08:37:09 +0000 Subject: [PATCH 3/4] note --- docs/docs/Usage/private_root.md | 4 ++++ 1 file changed, 4 insertions(+) diff --git a/docs/docs/Usage/private_root.md b/docs/docs/Usage/private_root.md index 06ea6209..889b2a5f 100644 --- a/docs/docs/Usage/private_root.md +++ b/docs/docs/Usage/private_root.md @@ -116,6 +116,10 @@ By implementing these steps, your network devices will use your private root ser When setting up devices with a custom planet configuration, it's important to note that mobile platforms have significant limitations compared to desktop systems. While this might be implemented in the official apps in the future, there is currently no ETA set. +:::warning Security Consideration +The following solutions are third-party modifications of the official ZeroTier apps. Before using any third-party applications, carefully review their source code and trust the developers, as they may pose security risks. Use these solutions at your own discretion and risk. +::: + ### Android Limitations and Workarounds The official ZeroTier Android app does not support direct custom planet configuration. There are several workarounds available: From a924187e2540671368f7bc0499eb90c8b1c6e9af Mon Sep 17 00:00:00 2001 From: Bernt Christian Egeland Date: Sun, 29 Dec 2024 08:38:54 +0000 Subject: [PATCH 4/4] note --- docs/docs/Usage/private_root.md | 7 +++++-- 1 file changed, 5 insertions(+), 2 deletions(-) diff --git a/docs/docs/Usage/private_root.md b/docs/docs/Usage/private_root.md index 889b2a5f..a1789ab2 100644 --- a/docs/docs/Usage/private_root.md +++ b/docs/docs/Usage/private_root.md @@ -116,8 +116,11 @@ By implementing these steps, your network devices will use your private root ser When setting up devices with a custom planet configuration, it's important to note that mobile platforms have significant limitations compared to desktop systems. While this might be implemented in the official apps in the future, there is currently no ETA set. -:::warning Security Consideration -The following solutions are third-party modifications of the official ZeroTier apps. Before using any third-party applications, carefully review their source code and trust the developers, as they may pose security risks. Use these solutions at your own discretion and risk. +:::warning Security and Legal Considerations +The following solutions are third-party modifications of the official ZeroTier apps. Please note: +- These modifications may not be legally approved by ZeroTier +- Before using any third-party applications, carefully review their source code and trust the developers, as they may pose security risks +- Use these solutions at your own discretion and risk ::: ### Android Limitations and Workarounds