Install the app

The Togo app runs on iPhone and iPad, with a companion app for Apple Watch. It connects to machines you own over SSH, so there is no account to create.

Requirements#

  • iOS or iPadOS 26.0 or later.
  • A Mac or Linux machine you can reach over SSH, with sshd running. On a Mac, that means Remote Login is on.
  • tmux 3.2 or newer on the machine, for sessions that survive disconnects.

The Watch app needs watchOS 26.0 or later and comes with the iPhone app. Install it from the Watch app on your iPhone. It lists waiting requests and lets you approve or deny them. The Watch holds its own approval key, which it registers through your phone.

Get the app#

Join the TestFlight beta. The App Store release is in review.

Add a machine#

  1. Open Togo and choose Add a machine.
  2. Enter the address (a host name, an IP address or a Tailscale name), the port and your user name.
  3. The first time Togo connects, it shows the machine's host key fingerprint. Compare it with the one the machine shows, then trust it. If the key changes later, Togo stops the connection and tells you.
  4. Add the app's public key to the machine. Togo makes the key on your device, and the private half never leaves it. Each use needs Face ID, Touch ID or your passcode.

To add the key, run this on the machine:

$ mkdir -p ~/.ssh
$ cat >> ~/.ssh/authorized_keys

Paste the key line from the app, press Return, then press Control-D.

Mosh#

Mosh keeps a session alive across network changes and sleep. The app has Mosh built in, and the machine needs mosh-server:

$ brew install mosh

On Debian or Ubuntu, use sudo apt install mosh. Mosh uses UDP ports 60000 to 61000, so a firewall on the machine has to allow them. If the connection falls back to plain SSH, run togo doctor on the machine. It checks mosh-server and the firewall. See Troubleshooting.

Next#

Install the optional helper on the machine: Install the helper.