diff --git a/scripts/setup/machine-setup/lib/tailscale.sh b/scripts/setup/machine-setup/lib/tailscale.sh index 53caa5a5..e619d1d4 100644 --- a/scripts/setup/machine-setup/lib/tailscale.sh +++ b/scripts/setup/machine-setup/lib/tailscale.sh @@ -62,14 +62,16 @@ tailscale_network_menu() { info "Which network should this machine join?" echo "" echo " [1] set up your own network — offscale" - echo " Your own coordination server, running on this machine. offscale" - echo " changes nothing about how any of it works: it is headscale's" - echo " open-source code, talking to stock Tailscale clients, exactly as" - echo " they already do. Same protocol, same clients, same behaviour." - echo " What it changes is the work — installing it, running it, keeping" - # TODO(pastilhas): name them. "a lot of goodies" is what every product says; - # two or three specifics are worth more than the sentence they replace. - echo " it upgraded — and it brings [ goodies to be listed ] with it." + echo " Your own coordination server, running on this machine. The" + echo " protocol is Tailscale's and the server is headscale's" + echo " open-source code — nothing about how machines find each other" + echo " changes. On computers you use the stock Tailscale client; on" + echo " iPhone, iPad and Android there is our own app, our own" + echo " implementation of the same protocol." + echo " What changes is the work: installing, running and upgrading it," + # TODO(pastilhas): more of them. The mobile apps are one specific worth naming; + # two or three others would be worth more than any sentence about "extras". + echo " and [ more goodies to be listed ]." echo "" echo " [2] use a network you already run — headscale or offscale" echo " You already have a coordination server somewhere. Point this" @@ -111,19 +113,25 @@ tailscale_networks_help() { echo "" echo " OFFSCALE" echo " Our own distribution of headscale, which is to say: headscale." - echo " The protocol is untouched and the code underneath is theirs. The" - echo " server speaks the same thing headscale speaks, the clients are the" - echo " stock Tailscale ones, and a machine on an offscale network behaves" - echo " exactly as it would on either of the other two. There is no" - echo " offscale protocol to be locked into, because there is no offscale" - echo " protocol." + echo " The protocol is untouched and the server is their open-source code," + echo " so a machine on an offscale network behaves exactly as it would on" + echo " either of the other two. There is no offscale protocol to be locked" + echo " into, because there is no offscale protocol." echo "" - echo " What differs is everything around it. Running headscale yourself is" - echo " a project: installing it, putting TLS in front of it, keeping it" - echo " upgraded, and administering it through a config file and a CLI." - echo " offscale makes that a step in a setup script instead, and adds" - # TODO(pastilhas): the specifics. - echo " [ goodies to be listed ] on top." + echo " On computers you use the stock Tailscale client, pointed at your" + echo " own server. On iPhone, iPad and Android there is our own app — our" + echo " implementation of the same protocol, rather than a wrapper around" + echo " theirs. That one matters more than it sounds: getting the official" + echo " mobile app to talk to a self-hosted server is the part of running" + echo " headscale that people give up at. Desktop apps of our own are not" + echo " there yet." + echo "" + echo " What differs otherwise is everything around the server. Running" + echo " headscale yourself is a project: installing it, putting TLS in" + echo " front of it, keeping it upgraded, administering it through a config" + echo " file and a CLI. offscale makes that a step in a setup script, and" + # TODO(pastilhas): the rest of the specifics. + echo " adds [ more goodies to be listed ] on top." echo "" echo " FOR OFFICER" echo " Whichever you pick, the tailnet is what Officer treats as its"