Get started
Login
© 2024

Three ways to run Tailscale on macOS

The current version of the Tailscale client requires macOS 11.0 (Big Sur) or later.

The best way to install Tailscale on macOS is to download and install our application from our package server.

Download Tailscale

However, there are three ways (variants) to run Tailscale on macOS. You can choose the method that best fits your needs.

All three variants share the same core functionality for connecting your macOS device to Tailscale. However, there are subtle differences in the way that the variants are packaged and how they interact with macOS. You should choose the variant that best fits your use case.

We recommend downloading and installing the standalone Tailscale app directly from our package server, as this variant offers more features, is not subject to limitations imposed on apps distributed via the App Store, and provides more control over the deployment of updates.

What are the differences?

Standalone variant

We always recommend installing the standalone variant of the Tailscale application on macOS.

In macOS 10.15, Apple added support for the system extensions approach to implement VPNs. System extensions offer a more secure alternative to the legacy Kernel Extensions technology previously used by many security and networking tools on older macOS versions. These extensions run with root privileges but remain within a sandbox, ensuring that Tailscale operates isolated from the macOS kernel. A key advantage of system extensions is their ability to be distributed outside of the Mac App Store. This allows us to offer a version of Tailscale that doesn't require an Apple ID for installation — you can simply open our .pkg installer to begin using Tailscale.

With the standalone variant of our app, security updates are promptly distributed since they don't need to undergo Apple's App Store review process. Additionally, Tailscale can detect third-party tools interfering with the VPN tunnel and notify you when conflicts are detected.

Mac App Store variant

To be in the Mac App Store, applications are required by Apple to run in the macOS App Sandbox, isolating the app from the rest of the system. When running in a sandbox, VPN applications need to be a Network Extension to implement VPNs or VPN-like functionality. The Network Extension system does not work for applications distributed outside of the Mac App Store.

The main advantage of installing Tailscale via the Mac App Store is that it is very easy to get started. However, because both the Tailscale app and its Network Extension are sandboxed and running as the local user, there are a number of limitations. For instance, a very common issue is that the Screen Time web filter can conflict with the Tailscale version distributed on the App Store.

Open source tailscaled variant

It is possible to run the open source Tailscale code (tailscaled) on macOS. This uses the kernel utun interface, rather than the Network Extension or System Extension frameworks. However, this variant does not include a graphical user interface (GUI); all functionality must be managed from the command line. Additionally when using the open source tailscaled variant, you won't be able to manage Tailscale from the VPN settings in macOS.

tailscaled on macOS is only recommended for unattended installs managed by experienced macOS system administrators.

Which should I choose?

Always start by downloading and installing our standalone macOS app. Install Tailscale from the Mac App Store only if you are unable to install the standalone variant, or if you're deploying Tailscale in an environment where relying on the Mac App Store for install and updates is essential.

Do not install the Mac App Store variant and the standalone Mac application variant on the same machine. Having both variants running simultaneously can prevent the Tailscale extension from launching. To safely switch between macOS variants, delete the Tailscale.app currently installed, empty the Trash, and reboot your Mac before attempting to install a different variant.

Comparison table

This table presents the major differences in functionality between the three variants:

App Store
Network Extension
Standalone
System Extension
tailscaled
utun interface
Availableyesyesyes
GUIyesyesno
CLIyesyesyes
Minimum macOSmacOS 11.0macOS 11.0macOS 10.15
Requires Apple IDyesnono
Run before loginno; sandboxednoyes
Keychain usedusernone; files on disknone; files on disk
Sandboxedyessystem ext onlyno
Auto-updatesyes; managed by the App Storeyes; managed in-app (Sparkle)no
Open Sourcenonoyes
MagicDNSyesyesyes
Taildropyesyesincomplete
Exit nodesyesyespartial; can advertise as exit node but cannot use them
MDM supportyesyesno
Can be a Tailscale SSH servernonoyes
Can be a Tailscale SSH clientyesyesyes
Supports tailscale ssh CLI commandno, must use the regular ssh commandyesyes
Supports services collectionnoyesyes
Compatible with Screen Time web filternoyesyes
Can generate configuration reports for supportlimitedyesno

Automating App Store installs

To automate installs of the Mac App Store version of Tailscale, the mas-cli tool lets you run:

mas install 1475387142

Last updated Aug 27, 2024