Support
Need help with TetherTTY, the iPhone/iPad SSH client? This page covers how to reach us, how to report bugs or security issues, and answers to common questions.
Contact
Email: webcommitswebdesigns@gmail.com
Bugs and feature requests: open an issue on GitHub Issues ↗.
Security reports
Please do not report security vulnerabilities in public issues. Instead,
use GitHub's private vulnerability reporting as described in the
project's
SECURITY.md ↗.
Frequently asked questions
What do I need to use TetherTTY?
An SSH server reachable from your device, with password authentication.
Currently only password authentication is supported — there is no SSH
key support yet. tmux or herdr on the server
is optional; without either, you can still open a plain shell.
It says tmux/herdr isn't installed on this host, but I have it installed
This usually means the tool is installed, but not on the
PATH used by a non-interactive SSH shell (the kind
TetherTTY uses to check for it). You can still open a plain shell on
that host.
Why do I get a host key warning / "host key changed"?
TetherTTY pins the SSH host key the first time it connects to a server, and refuses to connect if that key later changes. If you expect the change — for example after reinstalling the server — verify the server's fingerprint out-of-band, then explicitly replace the stored key in the app.
Why does it reconnect after I switch apps?
iOS suspends background apps and closes their network sockets.
TetherTTY reconnects and reattaches to the same tmux or
herdr session, which keeps running on the server the whole
time — nothing you were running is lost.
Why does it ask for Face ID again?
This happens after the app has spent 5 or more minutes in the background.
Why does it ask for Local Network access?
To reach SSH servers on your local network, such as a machine on the same Wi-Fi.
How do I delete my data?
Deleting a connection in the app removes its stored password and pinned host key. Deleting the app removes its local data. See the Privacy Policy for details.