Relay support

For setup questions, bug reports or feedback, email Tobias Kamber, the developer of Relay.

Contact Tobias

tobias@software-atelier.ch

Include your Relay version, iOS/iPadOS version, device model, and the exact error or steps to reproduce it. Redact screenshots and logs before sending them.

Never send passwords, private keys, key passphrases or sensitive terminal content.

Your first connection

  1. Tap + in Hosts and enter a name, server address and port.
  2. Choose User / Password, or select a supported SSH key from the vault. Ed25519 is recommended. For a new key, install its public part in your server’s ~/.ssh/authorized_keys.
  3. Connect and independently verify the displayed host fingerprint with your administrator or a trusted source. An administrator can check it with ssh-keygen -lf /etc/ssh/ssh_host_ed25519_key.pub.
  4. Trust the verified key to establish the connection. Don’t accept an unexpected fingerprint just to dismiss the warning.

Common questions

Why does my connection stop in the background?

iOS may suspend network connections after backgrounding Relay or locking your device. Enable Recover with tmux on the host if tmux is installed on the server. It can preserve remote programs across SSH disconnections, but does not keep the connection alive.

The server’s host key has changed. What now?

Relay blocks the connection intentionally. Check with your administrator and verify the new fingerprint through a trusted channel. Only after confirming a legitimate change should you forget the old entry in Settings → Known hosts and reconnect.

Why can’t I connect or authenticate?

Check the hostname, port, username, network/VPN access, and whether the server permits your chosen authentication method. Verify that the SSH service is reachable. A local server may also require allowing local-network access in iOS Settings.

Use Ed25519 where possible. RSA authentication currently uses legacy ssh-rsa / SHA-1 signatures, which modern servers may reject. Do not weaken your server’s security settings to make RSA work. Supported encrypted OpenSSH keys depend on their format, cipher and key-derivation settings; not all PEM or private-key formats are supported.

Does Relay support SFTP, Mosh or two-factor login?

Not currently. Relay does not include an SFTP browser, Mosh, jump hosts, port forwarding, agent forwarding, SSH config import, cloud synchronization or keyboard-interactive/2FA authentication.

Will my workspace move to a new device?

There is no Relay cloud sync. Device backups may include workspace metadata and trusted host keys. Keychain secrets are device-only and don’t migrate to a different device, so you must re-enter credentials there.

How do I remove saved information?

Hosts and snippets can be removed in the app; trusted host keys can be removed in Settings → Known hosts. Removing a host does not delete its associated credential or close an open session. Close sessions separately. A vault key can only be deleted after changing or removing hosts that reference it.

Do not rely on uninstalling alone to erase Keychain entries. For questions about residual credentials, contact support. Backups, remote server records and copied content must be managed separately.

Requirements

iPhone or iPad running iOS/iPadOS 17 or later, a reachable SSH server, and valid server credentials. No Relay account is required. Optional workspace authentication uses your device’s biometric or passcode authentication.

For information about storage, SSH connections, backups and support emails, read the Privacy Policy.