Skip to main content

Deploy Tailscale with the Swif App Template

Deploy Tailscale to Macs, iPhones and iPads with the Swif app template, without VPN prompts for users.

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

  1. In Swif, go to Device Management > Applications.

  2. Click View All Templates, find Tailscale, and click Configure.

  3. 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

  1. In the template, choose for iOS/iPadOS, and click Add Application.

  2. 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.

  1. Assign the Tailscale VPN Profile to the device group.

  2. Check that it's installed. Open a device, go to Profiles, and check that Tailscale VPN Profile shows Installed.

  3. 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

AuthKey

String

Your Tailscale auth key, such as tskey-auth-...

Hostname

String

A name for each device, such as acme-ipad-{{SERIAL}}

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.

  1. Download the standalone Tailscale package (.pkg) for macOS, from Tailscale.

  2. In the template, choose for macOS, and click Continue.

  3. Swif fills in the app's details:

Field

Value

Name

Tailscale

Domain

tailscale.com

Architectures

All

Tag

VPN Client

Validation path

/Applications/Tailscale.app

Identifier

io.tailscale.ipn.macsys

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

Did this answer your question?