ValdisValdis

Tailscale guide

Serve Valdis over Tailscale

Install the standalone Tailscale build, register both your Mac (host) and iPhone (client) on the same tailnet, and use Serve with HTTPS (MagicDNS required).

Download Tailscale for macOSRegister Mac + iPhone before starting.

macOS host setup

Start the local Valdis server, enable CLI integration, then approve Serve over HTTPS.

  1. Install the standalone Tailscale pkg for macOS and sign in. Ensure both Mac and iPhone are in the same tailnet.
  2. In Valdis, toggle the local server on, keep the default port 11303, and optionally set a Server password for extra protection.
  3. Enable CLI integration so tailscale is on PATH: Tailscale Settings → CLI integration → “Add Now”.
  4. Run Serve from the terminal (MagicDNS + HTTPS):
    zsh
    tailscale serve --bg --https 11303 127.0.0.1:11303
  5. If Serve is not enabled yet, open the auth link printed in the terminal and click “Enable HTTPS and Funnel” (Funnel optional).
  6. Keep Serve running; Valdis (including its WebSocket server) stays reachable at the HTTPS URL Tailscale issues for this node.

macOS

macOS flow

Valdis server toggle → CLI integration → Serve enablement.

Valdis server settings running on port 11303
Tailscale Settings showing CLI integration entry point
CLI Integration dialog with Add Now button
CLI Integration showing tailscale added to /usr/local/bin
Terminal requesting Serve enablement link
Tailscale web approval for HTTPS Serve

iOS client setup

MagicDNS is mandatory: raw IPs will fail HTTPS. Confirm the Mac node is online before wiring the provider.

  1. Install Tailscale from the App Store and sign in with the same account.
  2. Join the same tailnet and confirm the Mac is online.
  3. Copy the Mac’s MagicDNS name from the device list (do not use raw IPs).
  4. Copy the HTTPS Serve endpoint from the Mac node (MagicDNS-only) and paste it into Valdis on iOS when adding the provider.
  5. Connect; the HTTPS Serve endpoint should load via MagicDNS.

iOS

iOS flow

Pick the Mac node, copy the MagicDNS Serve endpoint, paste it into Valdis.

Select the Mac node inside Tailscale on iOS
Copy the MagicDNS Serve endpoint from the Mac node
Paste the Serve endpoint into Valdis provider setup on iOS