macOS and Windows
What works on a Mac or a Windows PC today, and how to connect your phone to one.
Link Host installs and runs on macOS and Windows, but Linux is the complete platform today. On a Mac or a PC, the phone signs in to the computer's own SSH server with your account password, at an address it can reach. There's no QR pairing, no rendezvous and no relay there yet, and no desktop.
| Linux | macOS | Windows | |
|---|---|---|---|
| Install with one command | Yes | Yes | Yes |
| Pair by QR code, phone's own key | Yes | — | — |
| Reach it from other networks, no settings | Yes | — | — |
| Agents | Yes | Yes | Needs a Unix shell |
| Terminal | tmux | tmux (from Homebrew), or a plain shell | A plain shell |
| Files | Yes | Yes | Yes |
| Desktop | Yes | — | — |
Early
The macOS and Windows builds are new and haven't been run against the app on real machines yet. If something doesn't work, open an issue.
macOS
Install Link Host:
curl -fsSL https://link.docs.razin.ai/install.sh | shTurn on Remote Login: System Settings → General → Sharing → Remote Login. This is macOS's built-in SSH server.
Print a connection code:
"$HOME/Library/Application Support/Link/Host/link-host" ssh connectIt prints a QR code and a link-ssh://connect?… code with the Mac's address, account and SSH host key, but no secret.
In the Link app, tap + and Scan QR code (or Import from Linux and paste the code), then enter your Mac account's password. The app checks the Mac's key against the code before sending the password.
The phone must be able to reach the address in the code: the same Wi-Fi, or a VPN such as Tailscale that you already use. Pass --host to put another address in the code. If the Mac has several network addresses, ssh connect asks you to choose one with --host.
Windows
Install Link Host in PowerShell:
irm https://link.docs.razin.ai/install.ps1 | iexAdd the OpenSSH Server: Settings → System → Optional features → Add a feature → OpenSSH Server. Then start it once, in an administrator PowerShell:
Start-Service sshd
Set-Service -Name sshd -StartupType AutomaticPrint a connection code:
& "$env:LOCALAPPDATA\Link\Host\link-host.exe" ssh connectIn the Link app, scan or import the code and sign in with your Windows account's password.
Windows' SSH server starts cmd.exe by default, so Files and a plain terminal work, but the Agents tab needs a Unix shell for its scripts. To run your agents from the phone on Windows today, install Link Host's Linux build inside WSL instead, with systemd turned on there.
Removing it
curl -fsSL https://link.docs.razin.ai/uninstall.sh | sh # macOSirm https://link.docs.razin.ai/uninstall.ps1 | iex # Windows