Support
Email us: enricofanucchi@gmail.com. We usually reply within two business days.
Please include the app version (at the bottom of Termina's Settings, ⌘,), device model, iOS version and, if possible, the server's SSH version (e.g. ssh -V). Never send passwords or private keys.
Getting started
- Tap + and enter the server's address, port and user, or type
user@host:portin Quick Connect. - Choose how to sign in: password, imported key, or a key generated in the Secure Enclave.
- Tap the server, confirm its fingerprint on the first connection, and you're in the shell.
Frequently asked questions
How do I use a Secure Enclave key?
In the server's settings choose Secure Enclave and tap Generate Key. Copy the line starting with ecdsa-sha2-nistp256 and add it to ~/.ssh/authorized_keys on the server. The private key never leaves the device's chip, so it only works on that device: on another iPhone or iPad you'll generate a new one.
Which keys can I import?
OpenSSH Ed25519 and RSA keys, with or without a passphrase, starting with -----BEGIN OPENSSH PRIVATE KEY-----. If your RSA key uses an older format, convert it on your computer with ssh-keygen -p -f ~/.ssh/id_rsa.
I see “the host key has changed”. What should I do?
The server is presenting a different identity from the one you confirmed before. This can happen after the server is reinstalled, but it can also mean someone is trying to intercept the connection. Check the fingerprint directly on the server (ssh-keygen -lf /etc/ssh/ssh_host_ed25519_key.pub). If it matches, long-press the server in the list, choose Forget Host Key, and connect again.
My keyboard has no Esc key
Press ⌘ . or use the esc key in the bar above the keyboard. You can also turn Caps Lock into Esc: Settings › General › Keyboard › Hardware Keyboard › Modifier Keys.
How do I press Ctrl on iPhone?
Tap ctrl in the bar above the keyboard, then the key you want: for example ctrl then c sends Ctrl-C. alt works the same way.
Why does my session close when I switch apps?
iOS suspends network connections of background apps after about 30 seconds. Termina reconnects automatically when you come back. To find your shell exactly as you left it, set a tmux session in the server's settings (tmux must be installed on the server).
My local tunnel doesn't respond in Safari
Local tunnels work while Termina stays in the foreground. On iPad, open Safari and Termina side by side (Split View or Slide Over), then visit http://localhost:PORT. If the tunnel shows an error, make sure AllowTcpForwarding is enabled on the server.
How do I reach my servers with Tailscale?
Install and turn on the Tailscale app, then use the server's 100.x.y.z address or its *.ts.net name. Termina shows in the sidebar whether Tailscale is active.
How do I transfer and edit files?
During a session open Files (⇧ ⌘ F). Drag files from the Files app to upload them; tap a file to preview or edit it (text up to 2 MB). Saving replaces the original only once the upload is complete, keeping its permissions.
How do I delete all my data?
Deleting a server also deletes its credentials. Uninstalling the app removes everything else: on the next install Termina also clears any items left in the Keychain. We keep no copies anywhere: see the Privacy Policy.
Keyboard shortcuts
| Keys | Action |
|---|---|
| ⌘T / ⌘W | New tab / close tab |
| ⌘1…⌘9, ⇧⌘[ ⇧⌘] | Go to tab / previous / next |
| ⌘K | Clear screen and scrollback |
| ⌘F, ⌘G, ⇧⌘G | Find, next, previous |
| ⌘+ ⌘- ⌘0 | Text size (also with two fingers) |
| ⌘. | Esc |
| ⇧⌘T / ⇧⌘F | Tunnels / Files |
| ⌘N / ⌘, | New server / Settings |
| ⌘R | Reconnect a closed session |