Reach your Mac from anywhere

With Tailscale · free for personal use · set up in about five minutes

At home, Telkino finds your Mac on its own. Away from home, you need a safe way to reach it. The easiest one is Tailscale: a private network for your own devices only, with no router settings and no open ports. For personal use the free Personal plan is enough.

Three steps

The images show the English interface. The iPhone crops have been retouched to anonymize personal details; names and addresses are examples. Use your own details. Tap an image to view it full size.

  1. Install Tailscale on the Mac and the iPhone. On the Mac from the App Store or from tailscale.com/download/mac, on the iPhone or iPad from the App Store. Sign in on both with the same account, for example with Apple, Google or Microsoft. Tailscale creates your private network at the first sign-in. On the iPhone, allow the VPN configuration when iOS asks.
    Tailscale shows Connected and a list of devices with online indicators.
    Open Tailscale: the status should read “Connected”. A green dot marks an online device.
  2. Turn on Screen Sharing on the Mac. Under System Settings › General › Sharing. If you already use Telkino at home, it is on.
    macOS System Settings: General and Sharing with Screen Sharing enabled.
    On your Mac, open General → Sharing and turn on Screen Sharing.
  3. Add the Mac in Telkino with its Tailscale name. Enter the device name from the Tailscale app as the host, for example mac-mini, and port 5900. Then connect as usual.

That’s it. Away from home, Tailscale only has to be switched on at the iPhone. The connection stays inside your encrypted Tailscale network; no Telkino server is involved. Tailscale may use its own relay when needed. Compatible Macs can also use Apple High Performance with HEVC video over Tailscale.

Good to know

Extra: add a computer with a Shortcut

Tailscale’s Find Devices action lists devices in your tailnet. The shortcut hands your selected device to Telkino. You check its details, enter your Mac username and password, and save the computer yourself.

Before you start: install Tailscale and Telkino, sign in to Tailscale and connect it. Your Mac must be online with Screen Sharing enabled. Appearing in the device list does not mean a device is running a VNC server.

Add the shortcut for iPhone and iPad

On your Mac? Scan the QR code with your iPhone or iPad camera. On your mobile device, tap the link directly.

QR code for the Telkino Tailscale shortcut on iCloud
  1. Add and run the shortcut. Open Tailscale first and check that you are signed in and connected. Then open the link above on your iPhone or iPad and add the shortcut. Then run it in the Shortcuts app.
    Telkino – Add Mac from Tailscale shortcut tile with its play button.
    Run “Telkino – Add Mac from Tailscale” in Shortcuts.
  2. Choose your Mac. Allow access to Tailscale and sharing with Telkino when Shortcuts asks. The list also includes other device types; choose your Mac with Screen Sharing enabled.
    Choose your Mac picker showing devices including macbook and mac-mini.
    Choose your Mac. Other device types can appear in this list too.
  3. Check the details in Telkino. Name, host and port 5900 are filled in. Add your Mac user account credentials and save. The shortcut does not save or connect automatically.
    Telkino Add dialog with name, example host and port 5900 filled in; credentials are empty.
    Name, host and port are already filled in. Enter your Mac username and password, then tap Save.

Tailscale is not running? Open the Tailscale app, wait until it is connected, then run the shortcut again. You may also need to do this after Tailscale has been closed.

Optional: build the shortcut yourself
  1. In Shortcuts, create a shortcut called “Add Mac from Tailscale”.
  2. Add Tailscale → Find Devices. Filter: Is Online is true. Leave the result limit off.
  3. Add Choose from List, using the found devices as input. Keep multiple selection off. Prompt: “Which Mac would you like to add?”
  4. Use the selected device’s MagicDNS Address property as the host. If it is empty, use its IPv4 Address. If both are empty, stop the shortcut with a message.
  5. Apply URL Encode separately to the device’s Name and the host. This preserves spaces, accented characters and an & in a device name.
  6. Add a URL action: telkino://add?name=[encoded name]&host=[encoded host]&port=5900. Replace the bracketed placeholders with the corresponding variables.
  7. Add Open URLs using that URL. Test it once: Telkino should open Add Computer with the fields filled in, without saving or connecting.

If the list is empty, check your Tailscale connection and that the Mac is online. You can also add the computer manually using its address from Tailscale. Action names depend on your system language. Tailscale’s Shortcuts guide

What Telkino does with the link

The link telkino://add opens the Add Computer editor and fills in name, host, port and optionally the user name (username=). Everything else stays with you: password, image quality, saving. Invalid links are ignored.