The Tailscale app template sets up Tailscale on your Macs, iPhones, and iPads in a few steps. It adds the Tailscale app, and creates the VPN profile Tailscale needs, so users aren't asked to approve a VPN when Tailscale first opens.
Why the VPN profile matters
Tailscale runs as a VPN. The first time it opens, it needs a VPN configuration on the device:
Without the VPN profile | With the VPN profile |
Tailscale creates its own VPN configuration. iOS and iPadOS ask the user for the device passcode to allow it. | Swif installs the VPN configuration first, as a profile. Tailscale finds it, and connects without asking the user. |
Managed app configuration, such as an AuthKey or Hostname, can't create a VPN configuration. It only sends settings to the app. So to deploy Tailscale without asking users, you need both the VPN profile and the app.
Open the template
In Swif, go to Device Management > Applications.
Click View All Templates, find Tailscale, and click Configure.
Choose for macOS, or for iOS/iPadOS, and click Continue.
Set up one platform at a time. If you choose both, Swif shows "Configure Tailscale for macOS and iOS/iPadOS one at a time."
Set up Tailscale for iPhone and iPad
In the template, choose for iOS/iPadOS, and click Add Application.
Swif adds the Tailscale app from the App Store, with the tag VPN Client, and creates a profile called Tailscale VPN Profile.
Deploy it without asking users
Do these steps in order. The profile must be on the device before Tailscale opens for the first time.
Assign the Tailscale VPN Profile to the device group.
Check that it's installed. Open a device, go to Profiles, and check that Tailscale VPN Profile shows Installed.
Install the Tailscale app, from your Apple Business Manager apps, to the same device group. To sign devices in automatically, add managed app configuration, such as an AuthKey and a Hostname. See Install Apple Business VPP Apps.
When Tailscale opens, it finds the VPN configuration, and connects without asking the user for a passcode.
For installs without any prompts, use supervised iPhones and iPads, enrolled with Automated Device Enrollment. On devices that aren't supervised, iOS asks the user to approve the app install itself, even with the VPN profile.
Example managed app configuration
Setting | Type | Value |
| String | Your Tailscale auth key, such as |
| String | A name for each device, such as |
Swif replaces {{SERIAL}} with each device's serial number. For every setting Tailscale accepts, see Tailscale's iOS MDM documentation.
Set up Tailscale for Mac
The Mac template uses Tailscale's standalone app for macOS, installed from a package, not the Mac App Store version.
Download the standalone Tailscale package (
.pkg) for macOS, from Tailscale.In the template, choose for macOS, and click Continue.
Swif fills in the app's details:
Field | Value |
Name | Tailscale |
Domain | tailscale.com |
Architectures | All |
Tag | VPN Client |
Validation path |
|
Identifier |
|
4. Attach the .pkg, and click Finish.
Swif adds Tailscale as a custom app, and creates a profile called Tailscale VPN Profile (macOS). The profile:
sets up Tailscale's VPN
approves Tailscale's system extension, so users aren't asked to allow it
Assign the profile before the app, for the same reason as on iPhone and iPad.
Keep the package up to date. To update Tailscale, upload the new package in the app's details. See Installing Custom Software via Swif.
Troubleshooting
Users are asked for a passcode when Tailscale opens
Tailscale opened before the Tailscale VPN Profile was installed, so it tried to create its own VPN configuration. Check that the profile shows Installed on the device. Deploy the profile before the app on new devices.
Users are asked to approve the app install
The iPhone or iPad isn't supervised. iOS asks users to approve app installs on devices that aren't supervised. See Install Apple Business VPP Apps.
Tailscale doesn't sign in by itself
Check the AuthKey in the app's managed app configuration. Tailscale only uses it when it opens, and isn't signed in yet. See Configure apps automatically in Install Apple Business VPP Apps.
Mac users are asked to allow a system extension
Check that Tailscale VPN Profile (macOS) is installed on the Mac. It approves Tailscale's system extension.
Related resources