---
title: "Connecting an Apple client"
description: "Connect the Tailscale clients for iOS, macOS and tvOS to your slopscale server by setting a custom coordination server before signing in."
sidebar:
  label: "Apple"
---

This documentation has the goal of showing how a user can use the official iOS and macOS [Tailscale](https://tailscale.com) clients with slopscale.

:::info[Instructions on your slopscale instance]

An endpoint with information on how to connect your Apple device
is also available at `/apple` on your running instance.
:::

## iOS

### Installation

Install the official Tailscale iOS client from the [App Store](https://apps.apple.com/app/tailscale/id1470499037).

### Configuring the slopscale URL

- Open the Tailscale app
- Click the account icon in the top-right corner and select `Log in…`.
- Tap the top-right options menu button and select `Use custom coordination server`.
- Enter your instance url (e.g `https://slopscale.example.com`)
- Enter your credentials and log in. Slopscale should now be working on your iOS device.

## macOS

### Installation

Choose one of the available [Tailscale clients for macOS](https://tailscale.com/docs/concepts/macos-variants) and
install it.

### Configuring the slopscale URL

#### Command line

Use Tailscale's login command to connect with your slopscale instance (e.g `https://slopscale.example.com`):

```
tailscale login --login-server <YOUR_SLOPSCALE_URL>
```

#### GUI

- Option + Click the Tailscale icon in the menu and hover over the Debug menu
- Under `Custom Login Server`, select `Add Account...`
- Enter the URL of your slopscale instance (e.g `https://slopscale.example.com`) and press `Add Account`
- Follow the login procedure in the browser

## tvOS

### Installation

Install the official Tailscale tvOS client from the [App Store](https://apps.apple.com/app/tailscale/id1470499037).

:::danger

**Don't** sign in to the Tailscale App before the slopscale URL is configured!
:::

### Configuring the slopscale URL

- Open Tailscale
- Click the button `Install VPN configuration` and confirm the appearing popup by clicking the `Allow` button, but don't sign in yet
- Open Settings (the Apple tvOS settings) > Apps > Tailscale
- Under `ALTERNATE COORDINATION SERVER URL`, select `URL`
- Enter the URL of your slopscale instance (e.g `https://slopscale.example.com`) and press `OK`
- Return to the tvOS Home screen and open Tailscale
- Scan the QR code and follow the login procedure