DuckTerm support & troubleshooting

Tap the + button on the Connections tab. Enter host, port, username, and either a password or upload a private key (.pem). Free tier supports up to 2 servers; Pro is unlimited. Tap the row to connect.

Mosh requires UDP port 60000–61000 to be open on your server. Check your firewall (ufw allow 60000:61000/udp) and any cloud security group. The server must have mosh-server installed (sudo apt install mosh on Debian/Ubuntu). DuckTerm uses your existing SSH credentials to bootstrap the Mosh handshake.

Open a server from Connections. The session picker lists tmux on POSIX/WSL, psmux on native Windows, and discovered Herdr agents/workspaces. Tap a row to enter that exact session (Pro only). Native iOS and Android use Ghostty when its health checks pass and automatically fall back to xterm; the web client uses xterm.

Open Settings → Pro. Choose monthly ($0.99/mo), yearly ($9.99/yr — saves 17%), or lifetime ($14.99 one-time). Purchases unlock immediately and restore on devices signed into the same store account (App Store Apple ID on iOS; Google account on Android).

Settings → Pro → Restore Purchases. As long as you're signed in with the same store account — your App Store Apple ID on iOS, or your Google account on Android — your Pro entitlement comes back instantly. The lifetime purchase restores even after a fresh install. Purchases restore on devices of the same store account.

Per-server biometric gating (Face ID on iOS; fingerprint/face unlock on Android) is set independently. Tap the server row → Edit → Authentication → toggle the biometric requirement. If you accidentally enrolled with the wrong server, just toggle off and re-enable on the right one.

Sync works within one platform. iOS: both devices signed into the same Apple ID with iCloud Drive on, and Settings → iCloud Sync enabled on both — DuckTerm's own sync carries metadata; credentials ride separately via iCloud Keychain (end-to-end encrypted by Apple) when you have it enabled. Android: both devices signed into the same Google account with Drive sync enabled — Android sync carries the full connection profile including credentials, stored in your private Drive appDataFolder (see the Privacy Policy). First sync can take a minute.

Subscriptions are managed by the store you bought from. iOS: Settings → your Apple ID → Subscriptions → DuckTerm → Cancel. Android: Google Play → profile → Payments & subscriptions → Subscriptions. You retain Pro access until the end of your billing period. The lifetime purchase isn't a subscription — there's nothing to cancel.

There is no single wipe button today — three steps remove nearly everything. 1) In the app, delete your servers and stored keys (this removes their credentials — including jump/proxy secrets and iCloud-synced Keychain copies). 2) Uninstall the app to remove local databases. 3) Remove cloud data at the source: iOS — Apple Account → iCloud → Manage Account Storage → DuckTerm; Android — Google Drive website → Settings → Manage apps → delete DuckTerm's hidden app data. What these steps do not remove yet: the cross-device push pairing token (synchronizable Keychain + iCloud key-value storage) — an in-app control for it is planned — contact us and we'll help disable the pairing and clean up the server side. Disconnecting Drive sync also does not delete remote data.