From 26a8d1be8f4024d930954de7d8250305ac449257 Mon Sep 17 00:00:00 2001
From: Brad Fitzpatrick <brad@danga.com>
Date: Thu, 18 Feb 2021 13:42:42 -0800
Subject: [PATCH] Created Tailscaled on macOS (markdown)

---
 Tailscaled-on-macOS.md | 59 ++++++++++++++++++++++++++++++++++++++++++
 1 file changed, 59 insertions(+)
 create mode 100644 Tailscaled-on-macOS.md

diff --git a/Tailscaled-on-macOS.md b/Tailscaled-on-macOS.md
new file mode 100644
index 0000000..f47124f
--- /dev/null
+++ b/Tailscaled-on-macOS.md
@@ -0,0 +1,59 @@
+# tailscaled on macOS
+
+There are multiple ways to use Tailscale on macOS:
+
+* The sandboxed GUI from the App Store: https://apps.apple.com/us/app/tailscale/id1475387142?mt=12
+* Standalone GUI DMG (in development, not yet available)
+* Using the open source `tailscaled` and `tailscale` CLI tools.
+
+This page is about how to do the latter.
+
+# Requirements
+
+## Install Go
+
+Install Go 1.15+ (Intel Macs) or Go 1.16+ (M1/Apple Silicon ARM macs), from https://golang.org/dl/ or HomeBrew, etc.
+
+We recommend Go 1.16.
+
+## Compile Tailscale
+
+With Go 1.16, it's as easy as:
+```
+$ go install tailscale.com/cmd/tailscale{,d}@main
+```
+
+### Run the `tailscaled` (daemon)
+
+```
+$ sudo tailscaled
+```
+
+Or, to run it in the background under launchd so it starts at system boot:
+
+```
+$ sudo tailscaled install-system-daemon
+```
+
+(to stop/uninstall `sudo tailscaled uninstall-system-daemon`)
+
+### Use the `tailscale` CLI tool
+
+See https://tailscale.com/kb/1080/cli (but ignore the `/Applications/Tailscale.app/Contents/MacOS/Tailscale` part; that's the path to the GUI's CLI)
+
+```
+$ tailscale up # 
+$ tailscale status
+````
+
+Enjoy.
+
+Use https://forum.tailscale.com/ for support.
+
+## Comparison to GUI version
+
+Compared to the GUI version of Tailscale, running `tailscaled` instead has the following differences:
+
+* MagicDNS works, but you need to set 100.100.100.100 as your DNS server yourself. It doesn't yet change your DNS config.
+* `tailscaled` can run at system boot before any user has logged in (e.g. letting you VNC to your computer after a power outage)
+* is fully open source (Tailscale GUI parts aren't open source on non-free operating systems)