From 1d7c5f6e33c22bd4115bf9a15cef4b677795c24b Mon Sep 17 00:00:00 2001 From: travisladuke Date: Fri, 17 Jan 2025 11:02:34 -0800 Subject: [PATCH 1/2] Update self-hosting page --- docs/selfhosting.md | 18 ++++++++++++------ 1 file changed, 12 insertions(+), 6 deletions(-) diff --git a/docs/selfhosting.md b/docs/selfhosting.md index ef2335e..96c2a04 100644 --- a/docs/selfhosting.md +++ b/docs/selfhosting.md @@ -3,23 +3,29 @@ title: Self Hosting description: Host your own ZeroTier infrastructure --- -Hosting your own ZeroTier infrastructure is easy. There are 2 types of ZeroTier infrastructure and each serves a different role: +There are 2 types of ZeroTier infrastructure that can be self-hosted. ### Network Controllers -Controllers handle [Virtual Layer 2](protocol#vl2). No traffic is handled by controllers. ZeroTier Inc runs controllers with a web UI and API at [ZeroTier Central](https://my.zerotier.com). You can [self-host controllers](controller), but we don't currently offer the web UI for self-hosting. You'll have to use the json api. +Controllers handle [Virtual Layer 2](protocol#vl2). No traffic is handled by controllers. -The controller is open-source. Please check the [license](https://github.com/zerotier/ZeroTierOne/blob/master/LICENSE.txt). It's built in to the zerotier-one binary. +ZeroTier Inc runs controllers with a web UI and API at [ZeroTier Central](https://my.zerotier.com). You can [self-host controllers](controller), but we don't currently offer the web UI for self-hosting. You'll have to use the [json api](https://docs.zerotier.com/api/service/ref-v1/#tag/Controller) to manage your networks. + +The controller is open-source. Please check the [license](https://github.com/zerotier/ZeroTierOne/blob/master/LICENSE.txt). The controller service is built in to the zerotier-one binary if you use our [downloads](https://www.zerotier.com/download). ### Roots Roots handle [Virtual Layer 1](protocol#peerdiscovery). -ZeroTier, Inc hosts the roots. Setup for peer to peer connections happen via the roots. If p2p connections can't be made, traffic is "relayed" through these roots. +ZeroTier, Inc hosts the roots. Setup for peer to peer connections happen via the roots. If peer to peer connections can't be made, traffic is "relayed" through these roots. :::note All traffic is end-to-end encrypted. The roots can't read anything that passes through them. ::: -You can [host your own roots](roots) (previously called "moons") in addition to ZeroTier's, but we can't provide support for removing ZeroTier's roots (unless you are a large enterprise customer). The mobile apps don't currently support custom roots. +You can [host your own roots](roots) ("moons") in addition to ZeroTier's, but we can't provide support for removing ZeroTier's roots except to enterprise customers. The mobile apps don't currently support custom roots. + +If you are not using ZeroTier Inc's default root setup, your nodes won't be talk to nodes that are. Only devices configured with your custom roots will find each other. + +If you want to add additional roots and still talk to standard nodes, see [moons](roots). -If you are using a custom root setup, your nodes won't be able to find standard nodes. If you want to add additional roots and still talk to standard nodes, see [moons](roots). +Roots require stable IP addresses. From ba2588dd09b911a3644ed8ed47ccde66d405b173 Mon Sep 17 00:00:00 2001 From: travisladuke Date: Fri, 17 Jan 2025 11:05:17 -0800 Subject: [PATCH 2/2] Discourage moons --- docs/roots.md | 4 ++++ 1 file changed, 4 insertions(+) diff --git a/docs/roots.md b/docs/roots.md index d78575d..953a5e8 100644 --- a/docs/roots.md +++ b/docs/roots.md @@ -5,6 +5,10 @@ description: How to host your own root servers ### Creating Your Own Roots (a.k.a. Moons) +:::warning +Using moons is now discouraged. Please contact us for advice and alternatives. +::: + All ZeroTier nodes on a planet effectively inhabit a single data center. This makes it easy to directly connect devices anywhere, but it has the disadvantage of not