Write to us
Email [email protected]. Say which device and app version you’re on, the version of Hako for Mac, and what you did just before it went wrong. Leave out hostnames, addresses, passwords, keys and terminal output, and crop anything private out of screenshots.
Setting up your Macs
Install Hako for Mac on each Mac that runs your agents. It needs macOS 15 or later, and sets up herdr, which keeps your agents’ terminals running. Macs on your iCloud account appear in the app on their own while its sidebar is open, as long as iCloud Keychain and Tailscale are on. Without iCloud Keychain, pair by scanning the QR code from the Mac.
A Mac doesn’t show up
Check that the Mac is awake, that Hako for Mac is running there, and that both devices are on Tailscale. Your agents run on the Mac, so a sleeping Mac counts as offline. If you tapped Cancel or Forget for that Mac before, tap Connect to try again.
SSH or Mosh won’t connect
Turn on Remote Login on a Mac, or run sshd on Linux, then check the address, port, user and firewall. Mosh also needs mosh-server on the host and UDP getting through. If the host key changed, the app refuses it: check the key on the host before you use Edit Host → Reset Trust.
No notification arrived
Notifications are off until you turn them on. In Settings → Paired Macs, turn them on for that Mac and check it isn’t muted, then check Hako in your device’s notification settings. An alert that couldn’t be delivered before it expired isn’t sent late. If you aren’t sure a reply arrived, open the pane and look before sending it again.
Try it without a Mac
Tap the gear at the top left, then Developer → Demo mode. It fills the app with simulated Macs and agents, so you can look around first. It turns off when you relaunch the app.
What leaves your devices is on the privacy page.