2023-09-01 06:58:29 +00:00
|
|
|
<!doctype html>
|
2022-11-04 11:27:23 +00:00
|
|
|
<html lang="en">
|
|
|
|
|
<head>
|
|
|
|
|
<meta charset="UTF-8" />
|
|
|
|
|
<meta http-equiv="X-UA-Compatible" content="IE=edge" />
|
|
|
|
|
<meta name="viewport" content="width=device-width, initial-scale=1.0" />
|
2023-02-09 13:49:05 +00:00
|
|
|
<title>headscale - Apple</title>
|
|
|
|
|
<style>
|
|
|
|
|
body {
|
|
|
|
|
margin: 40px auto;
|
|
|
|
|
max-width: 800px;
|
|
|
|
|
line-height: 1.5;
|
|
|
|
|
font-size: 16px;
|
|
|
|
|
color: #444;
|
|
|
|
|
padding: 0 10px;
|
|
|
|
|
font-family: Sans-serif;
|
|
|
|
|
}
|
2023-03-15 11:31:38 +00:00
|
|
|
|
2023-02-09 13:49:05 +00:00
|
|
|
h1,
|
|
|
|
|
h2,
|
|
|
|
|
h3 {
|
|
|
|
|
line-height: 1.2;
|
|
|
|
|
}
|
|
|
|
|
</style>
|
2022-11-04 11:27:23 +00:00
|
|
|
</head>
|
|
|
|
|
|
|
|
|
|
<body>
|
2023-03-15 11:31:38 +00:00
|
|
|
<h1>headscale: macOS configuration</h1>
|
2022-11-25 15:06:39 +00:00
|
|
|
<h2>Recent Tailscale versions (1.34.0 and higher)</h2>
|
|
|
|
|
<p>
|
|
|
|
|
Tailscale added Fast User Switching in version 1.34 and you can now use
|
|
|
|
|
the new login command to connect to one or more headscale (and Tailscale)
|
|
|
|
|
servers. The previously used profiles does not have an effect anymore.
|
|
|
|
|
</p>
|
2022-12-05 13:58:06 +00:00
|
|
|
<h3>Command line</h3>
|
2022-11-25 15:06:39 +00:00
|
|
|
<p>Use Tailscale's login command to add your profile:</p>
|
|
|
|
|
<pre><code>tailscale login --login-server {{.URL}}</code></pre>
|
2022-12-05 13:58:06 +00:00
|
|
|
<h3>GUI</h3>
|
|
|
|
|
<ol>
|
|
|
|
|
<li>
|
|
|
|
|
ALT + Click the Tailscale icon in the menu and hover over the Debug menu
|
|
|
|
|
</li>
|
2022-12-27 10:41:27 +00:00
|
|
|
<li>Under "Custom Login Server", select "Add Account..."</li>
|
2022-12-05 13:58:06 +00:00
|
|
|
<li>
|
|
|
|
|
Enter "{{.URL}}" of the headscale instance and press "Add Account"
|
|
|
|
|
</li>
|
|
|
|
|
<li>Follow the login procedure in the browser</li>
|
|
|
|
|
</ol>
|
2022-11-25 15:06:39 +00:00
|
|
|
<h2>Apple configuration profiles (1.32.0 and lower)</h2>
|
2022-11-04 11:27:23 +00:00
|
|
|
<p>
|
|
|
|
|
This page provides
|
2023-03-15 11:31:38 +00:00
|
|
|
<a href="https://support.apple.com/guide/mdm/mdm-overview-mdmbf9e668/web"
|
|
|
|
|
>configuration profiles</a
|
|
|
|
|
>
|
2022-11-04 11:27:23 +00:00
|
|
|
for the official Tailscale clients for
|
|
|
|
|
</p>
|
|
|
|
|
<ul>
|
|
|
|
|
<li>
|
2023-03-17 14:56:15 +00:00
|
|
|
<a href="https://apps.apple.com/app/tailscale/id1475387142"
|
2022-11-04 11:27:23 +00:00
|
|
|
>macOS - AppStore Client</a
|
|
|
|
|
>.
|
|
|
|
|
</li>
|
|
|
|
|
<li>
|
|
|
|
|
<a href="https://pkgs.tailscale.com/stable/#macos"
|
|
|
|
|
>macOS - Standalone Client</a
|
|
|
|
|
>.
|
|
|
|
|
</li>
|
|
|
|
|
</ul>
|
|
|
|
|
<p>
|
|
|
|
|
The profiles will configure Tailscale.app to use <code>{{.URL}}</code> as
|
|
|
|
|
its control server.
|
|
|
|
|
</p>
|
|
|
|
|
<h3>Caution</h3>
|
|
|
|
|
<p>
|
|
|
|
|
You should always download and inspect the profile before installing it:
|
|
|
|
|
</p>
|
2022-12-22 14:19:02 +00:00
|
|
|
<ul>
|
|
|
|
|
<li>
|
2023-03-15 11:31:38 +00:00
|
|
|
for app store client: <code>curl {{.URL}}/apple/macos-app-store</code>
|
2022-12-22 14:19:02 +00:00
|
|
|
</li>
|
|
|
|
|
<li>
|
2023-03-15 11:31:38 +00:00
|
|
|
for standalone client: <code>curl {{.URL}}/apple/macos-standalone</code>
|
2022-12-22 14:19:02 +00:00
|
|
|
</li>
|
|
|
|
|
</ul>
|
2022-11-04 11:27:23 +00:00
|
|
|
<h2>Profiles</h2>
|
|
|
|
|
<h3>macOS</h3>
|
|
|
|
|
<p>
|
|
|
|
|
Headscale can be set to the default server by installing a Headscale
|
|
|
|
|
configuration profile:
|
|
|
|
|
</p>
|
|
|
|
|
<p>
|
|
|
|
|
<a href="/apple/macos-app-store" download="headscale_macos.mobileconfig"
|
|
|
|
|
>macOS AppStore profile</a
|
|
|
|
|
>
|
|
|
|
|
<a href="/apple/macos-standalone" download="headscale_macos.mobileconfig"
|
|
|
|
|
>macOS Standalone profile</a
|
|
|
|
|
>
|
|
|
|
|
</p>
|
|
|
|
|
<ol>
|
|
|
|
|
<li>
|
|
|
|
|
Download the profile, then open it. When it has been opened, there
|
|
|
|
|
should be a notification that a profile can be installed
|
|
|
|
|
</li>
|
|
|
|
|
<li>Open System Preferences and go to "Profiles"</li>
|
|
|
|
|
<li>Find and install the Headscale profile</li>
|
|
|
|
|
<li>Restart Tailscale.app and log in</li>
|
|
|
|
|
</ol>
|
|
|
|
|
<p>Or</p>
|
|
|
|
|
<p>
|
|
|
|
|
Use your terminal to configure the default setting for Tailscale by
|
|
|
|
|
issuing:
|
|
|
|
|
</p>
|
|
|
|
|
<ul>
|
|
|
|
|
<li>
|
|
|
|
|
for app store client:
|
|
|
|
|
<code>defaults write io.tailscale.ipn.macos ControlURL {{.URL}}</code>
|
|
|
|
|
</li>
|
|
|
|
|
<li>
|
2022-11-29 22:56:13 +00:00
|
|
|
for standalone client:
|
2022-11-04 11:27:23 +00:00
|
|
|
<code>defaults write io.tailscale.ipn.macsys ControlURL {{.URL}}</code>
|
|
|
|
|
</li>
|
|
|
|
|
</ul>
|
|
|
|
|
<p>Restart Tailscale.app and log in.</p>
|
2023-03-15 11:31:38 +00:00
|
|
|
<h1>headscale: iOS configuration</h1>
|
2023-03-17 14:56:15 +00:00
|
|
|
<h2>Recent Tailscale versions (1.38.1 and higher)</h2>
|
2023-03-15 11:31:38 +00:00
|
|
|
<p>
|
2023-03-17 14:56:15 +00:00
|
|
|
Tailscale 1.38.1 on
|
|
|
|
|
<a href="https://apps.apple.com/app/tailscale/id1470499037">iOS</a>
|
2023-03-15 11:31:38 +00:00
|
|
|
added a configuration option to allow user to set an "Alternate
|
|
|
|
|
Coordination server". This can be used to connect to your headscale
|
|
|
|
|
server.
|
|
|
|
|
</p>
|
|
|
|
|
<h3>GUI</h3>
|
|
|
|
|
<ol>
|
2023-03-17 14:56:15 +00:00
|
|
|
<li>
|
|
|
|
|
Install the official Tailscale iOS client from the
|
|
|
|
|
<a href="https://apps.apple.com/app/tailscale/id1470499037"
|
|
|
|
|
>App store</a
|
|
|
|
|
>
|
|
|
|
|
</li>
|
2023-03-15 11:31:38 +00:00
|
|
|
<li>
|
|
|
|
|
Open Tailscale and make sure you are <i>not</i> logged in to any account
|
|
|
|
|
</li>
|
|
|
|
|
<li>Open Settings on the iOS device</li>
|
|
|
|
|
<li>
|
|
|
|
|
Scroll down to the "third party apps" section, under "Game Center" or
|
|
|
|
|
"TV Provider"
|
|
|
|
|
</li>
|
|
|
|
|
<li>
|
2023-03-17 14:56:15 +00:00
|
|
|
Find Tailscale and select it
|
|
|
|
|
<ul>
|
2023-03-15 11:31:38 +00:00
|
|
|
<li>
|
|
|
|
|
If the iOS device was previously logged into Tailscale, switch the
|
|
|
|
|
"Reset Keychain" toggle to "on"
|
|
|
|
|
</li>
|
2023-03-17 14:56:15 +00:00
|
|
|
</ul>
|
2023-03-15 11:31:38 +00:00
|
|
|
</li>
|
|
|
|
|
<li>Enter "{{.URL}}" under "Alternate Coordination Server URL"</li>
|
2023-03-17 14:56:15 +00:00
|
|
|
<li>
|
|
|
|
|
Restart the app by closing it from the iOS app switcher, open the app
|
|
|
|
|
and select the regular sign in option <i>(non-SSO)</i>. It should open
|
|
|
|
|
up to the headscale authentication page.
|
|
|
|
|
</li>
|
|
|
|
|
<li>
|
|
|
|
|
Enter your credentials and log in. Headscale should now be working on
|
|
|
|
|
your iOS device
|
|
|
|
|
</li>
|
2023-03-15 11:31:38 +00:00
|
|
|
</ol>
|
2022-11-04 11:27:23 +00:00
|
|
|
</body>
|
|
|
|
|
</html>
|
