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.
-
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.
Open Tailscale: the status should read “Connected”. A green dot marks an online device. - 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
- Instead of the short name, the full name such as
mac-mini.tailnet-1234.ts.netor the 100.x.y.z address from the Tailscale app works too. - To reach the Mac from away, it should not go to sleep. Wake on LAN only works on the same network, not over Tailscale.
- Telkino finds computers via Bonjour only on the local network. Over Tailscale you enter the name once yourself, or use the Shortcut below.
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.
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
- In Shortcuts, create a shortcut called “Add Mac from Tailscale”.
- Add Tailscale → Find Devices. Filter: Is Online is true. Leave the result limit off.
- Add Choose from List, using the found devices as input. Keep multiple selection off. Prompt: “Which Mac would you like to add?”
- 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.
- Apply URL Encode separately to the device’s Name and the host. This preserves spaces, accented characters and an & in a device name.
- Add a URL action:
telkino://add?name=[encoded name]&host=[encoded host]&port=5900. Replace the bracketed placeholders with the corresponding variables. - 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.



