Docs · Topic
Hosts and keys
Moshpit connects to any standard SSH server. Passwords and private keys live in the iOS Keychain on your device and are never uploaded to any account or server of ours.
Add or edit a connection
Section titled “Add or edit a connection”Tap Add connection on Home, or long-press an existing host card to open Edit connection:
- Name and Emoji: give the host a friendly label and an optional single emoji.
- Host, Port, and User: enter the hostname or IP address alone (such as
dev.example.comor192.0.2.10), port (22by default), and SSH username (dev). - Sign in with: choose Password, SSH key, or Paste PEM.
- Multiplexer: choose tmux, herdr, or None. If the multiplexer you picked isn’t installed on the host, Moshpit tells you and opens a plain shell instead of switching to the other one.
Passwords, SSH keys, and Face ID
Section titled “Passwords, SSH keys, and Face ID”Manage reusable keys under Settings › SSH keys › Add Key:
| Method | Details |
|---|---|
| Generate (software) | Creates an ED25519 (recommended) or RSA-4096 key pair on the phone and stores it in the iOS Keychain. Turn on Require Face ID to require biometric confirmation before signing. |
| Generate (Store in Secure Enclave) | Generates a hardware-backed ECDSA P-256 key inside the Secure Enclave. The private key never leaves the chip, and signatures use Face ID. |
| Import | Tap Import File… or paste an OpenSSH or PEM private key. If the key has a Passphrase, you enter it once during import; the Keychain protects the unlocked key afterward. |
| Paste PEM | Paste a private key directly on a single connection under Sign in with › Paste PEM. |
Tap any key in Settings › SSH keys for Copy Public Key or Share Public Key, then add that line to ~/.ssh/authorized_keys on your host.
Host key trust and the host face
Section titled “Host key trust and the host face”On your first connection to a server, Moshpit displays New Host with its SHA256 fingerprint. Compare it with ssh-keygen -lf /etc/ssh/ssh_host_*_key.pub on the server and tap Trust.
If a server later presents a different key, Moshpit blocks the connection with Host Key Changed and shows both the Stored and Offered now fingerprints. Tap Disconnect unless you know why the server’s key changed (such as an OS reinstall), in which case tap Trust New Key.
Each host card wears a geometric face generated deterministically from its trusted host key—or a pixel creature when Pixel Companion is enabled. Setting an Emoji on the connection replaces that mark so you can tell hosts apart at a glance.
Restoring onto a new iPhone
Section titled “Restoring onto a new iPhone”When you set up a new iPhone from a backup, your saved connections and trusted host keys carry over, while iOS keeps Keychain items on the old device:
- Imported keys: listed under NOT ON THIS IPHONE in Settings › SSH keys. Tap a key and choose Import Again… to restore its private key without losing its host bindings.
- Secure Enclave keys: cannot leave the original device’s chip. Delete the old entry, generate a new key, and add the new public key to your server.
- Passwords and inline PEM keys: opening Edit connection prompts you to enter the password or paste the private key again.