Troubleshooting

Run the check on the machine first. It reads the machine and changes nothing.

$ togo doctor

Each line gives a check name, a status and a message. When a fix exists, it follows fix:. Add --json to get the same report as JSON.

ssh#

Remote Login is off, so the phone cannot connect: on a Mac, turn on System Settings › General › Sharing › Remote Login.

Nothing answers on SSH port 22, so the phone cannot connect: on Linux, install and start the OpenSSH server (sshd).

The check only tries port 22 on the machine itself. If your sshd listens on another port, you can ignore this line.

tmux#

tmux is not installed: install it with brew install tmux on macOS or sudo apt install tmux on Linux. Togo can't run sessions without it.

tmux 2.9 is too old; Togo needs 3.2 or newer (with your version): upgrade tmux to 3.2 or newer, then run the check again.

could not read the tmux version: tmux was found but did not report a version. Run tmux -V to see why.

mosh-server#

mosh-server is not installed: install it on the machine with brew install mosh or sudo apt install mosh.

found outside the login PATH; Togo finds it, other Mosh clients may not: Togo works. If another Mosh client fails with "command not found", add the folder to the PATH your shell sets for non-interactive logins.

If the app connects but Mosh never starts, the firewall is the usual cause.

Agents#

Each agent gets a line named after its command, such as claude or codex.

not found on the login PATH or in common install folders: the agent isn't installed, or is somewhere Togo doesn't look. You only need the agents you use.

found outside the login PATH; Togo launches it by full path: Togo works. Your own SSH commands may not find the agent.

firewall#

Mosh sends UDP packets on ports 60000 to 61000.

macOS firewall is on: allow mosh-server to receive UDP 60000-61000: in System Settings, open Network, then Firewall, and allow incoming connections for mosh-server.

If a firewall is on, open UDP 60000-61000 for Mosh (Linux and others): open that UDP range for the machine in ufw, firewalld or your cloud security group.

macOS firewall is off: no action needed.

tailscale#

not installed; install it to reach this machine away from home: Tailscale is optional. Install it from tailscale.com/download if you want to reach the machine from outside your network.

installed but not running: open Tailscale and sign in.

installed but not connected: run tailscale up.

turn on MagicDNS for a name that never changes: the machine is connected by IP address only. Turn on MagicDNS in Tailscale to give it a name.

The tailscale ssh line, Tailscale SSH is on and can stall key logins, appears only when Tailscale SSH is on. If key logins from the phone hang, run tailscale set --ssh=false to use the machine's own sshd. You can still reach the machine by its Tailscale name.

routes#

no network address found; the phone can only use the address you typed: the helper found no LAN or Tailscale address to offer the app. The machine still works at the address you entered.

awake#

off: sleeps as usual while sessions work: the machine may sleep while an agent is working. Run togo awake plugged to keep it awake on power, with the lid closed.

battery mode is not set up; a closed lid on battery still sleeps: run togo awake battery.

linger#

On Linux, off means Togo stops when you log out. To keep it running, run sudo loginctl enable-linger with your user name.

etserver#

Optional. Togo offers Eternal Terminal only on hosts with etserver: nothing is wrong. Install etserver if you want Eternal Terminal as a transport.

Still stuck#

Open a discussion at https://github.com/gettogo/togo/discussions and paste the output of togo doctor --json with any host names removed.