headscale

Apple configuration profiles

This page provides configuration profiles for the official Tailscale clients for

• iOS
• macOS - AppStore Client.
• macOS - Standalone Client.

The profiles will configure Tailscale.app to use {{.URL}} as its control server.

Caution

You should always download and inspect the profile before installing it:

curl {{.URL}}/apple/macos

Profiles

macOS

Headscale can be set to the default server by installing a Headscale configuration profile:

macOS AppStore profile macOS Standalone profile

1. Download the profile, then open it. When it has been opened, there should be a notification that a profile can be installed
2. Open System Preferences and go to "Profiles"
3. Find and install the Headscale profile
4. Restart Tailscale.app and log in

Or

Use your terminal to configure the default setting for Tailscale by issuing:

• for app store client: defaults write io.tailscale.ipn.macos ControlURL {{.URL}}
• for standalone client: defaults write io.tailscale.ipn.macsys ControlURL {{.URL}}

Restart Tailscale.app and log in.