From 8012e1cbd2bd28c7eba8cdabdfa59bb504b1a876 Mon Sep 17 00:00:00 2001
From: Kristoffer Dalby
Date: Wed, 15 Mar 2023 11:31:38 +0000
Subject: [PATCH] Add instructions on how to login to iOS (#1261)
---
CHANGELOG.md | 3 +-
templates/apple.html | 71 +++++++++++++++++++++++++-------------------
2 files changed, 42 insertions(+), 32 deletions(-)
diff --git a/CHANGELOG.md b/CHANGELOG.md
index 70c3f5f3..cb2fbd19 100644
--- a/CHANGELOG.md
+++ b/CHANGELOG.md
@@ -4,7 +4,8 @@
### changes
-- Adding "configtest" CLI command.
+- Adding "configtest" CLI command. [#1230](https://github.com/juanfont/headscale/pull/1230)
+- Add documentation on connecting with iOS to `/apple` [#1261](https://github.com/juanfont/headscale/pull/1261)
## 0.20.0 (2023-02-03)
diff --git a/templates/apple.html b/templates/apple.html
index c2331953..d09f786b 100644
--- a/templates/apple.html
+++ b/templates/apple.html
@@ -15,6 +15,7 @@
padding: 0 10px;
font-family: Sans-serif;
}
+
h1,
h2,
h3 {
@@ -24,7 +25,7 @@
- headscale: Apple configuration
+ headscale: macOS configuration
Recent Tailscale versions (1.34.0 and higher)
Tailscale added Fast User Switching in version 1.34 and you can now use
@@ -34,7 +35,6 @@
Command line
Use Tailscale's login command to add your profile:
tailscale login --login-server {{.URL}}
-
GUI
-
@@ -46,21 +46,15 @@
- Follow the login procedure in the browser
-
Apple configuration profiles (1.32.0 and lower)
This page provides
-
- configuration profiles
-
+ configuration profiles
for the official Tailscale clients for
-
Caution
You should always download and inspect the profile before installing it:
-
-
- for app store client:
-
curl {{.URL}}/apple/macos-app-store
+ for app store client: curl {{.URL}}/apple/macos-app-store
-
- for standalone client:
-
curl {{.URL}}/apple/macos-standalone
+ for standalone client: curl {{.URL}}/apple/macos-standalone
-
Profiles
-
-
-
macOS
Headscale can be set to the default server by installing a Headscale
@@ -117,7 +96,6 @@
>macOS Standalone profile
-
-
Download the profile, then open it. When it has been opened, there
@@ -127,7 +105,6 @@
- Find and install the Headscale profile
- Restart Tailscale.app and log in
-
Or
Use your terminal to configure the default setting for Tailscale by
@@ -143,7 +120,39 @@
defaults write io.tailscale.ipn.macsys ControlURL {{.URL}}
-
Restart Tailscale.app and log in.
+ headscale: iOS configuration
+ Recent Tailscale versions (1.38.0 and higher)
+
+ Tailscale 1.38 on
+ iOS
+ added a configuration option to allow user to set an "Alternate
+ Coordination server". This can be used to connect to your headscale
+ server.
+
+ GUI
+
+ -
+ Open Tailscale and make sure you are not logged in to any account
+
+ - Open Settings on the iOS device
+ -
+ Scroll down to the "third party apps" section, under "Game Center" or
+ "TV Provider"
+
+ -
+ Find Tailscale and enter the settings
+
+ -
+ If the iOS device was previously logged into Tailscale, switch the
+ "Reset Keychain" toggle to "on"
+
+
+
+ - Enter "{{.URL}}" under "Alternate Coordination Server URL"
+ - Open Tailscale and log in to the Headscale server
+