WatermSupport
Contact: support@waterm.app
Please include your device, iOS version and Waterm version (Settings › About Waterm), and what you did before the problem. For a connection error, tap "Copy Diagnostic Details" and paste them into your email; check them first, because they can include host names.
Requirements
Waterm runs on iPhone and iPad with iOS 17 or later. On iPad it runs in a single window. Waterm is currently in TestFlight beta and coming soon to the App Store. It isn't available on the China mainland App Store yet.
Questions
How does the free trial work?
Every Pro feature is free for 30 days, counted from when you first downloaded Waterm from the App Store. You don't need to buy anything or sign up, and reinstalling doesn't restart the trial. In the TestFlight beta, the 30 days count from when you first open Waterm. When it ends, the free features keep working. Pro features show the purchase options when you use them.
What's free and what's in Pro?
Free: SSH, SFTP, unlimited hosts, key security, session restoration, Tailscale, iCloud Sync, and previews of images, video, PDF, Markdown, JSON and text.
Pro: Herdr integration and agent notifications, image and Share Extension uploads, code and HTML preview, voice input, and Session Live Activity.
How do I restore a purchase on a new device?
Sign in with the same Apple Account, open Settings › Waterm Pro in Waterm and tap "Restore Purchases". Purchases are checked by Apple on your device, so there's no Waterm account to sign in to.
How do I cancel or change a subscription?
Tap "Manage Subscription" on the Waterm Pro page, or open the Settings app, tap your name, then Subscriptions. Cancel at least 24 hours before the current period ends to avoid the next charge.
I bought the one-time purchase while subscribed. Is my subscription cancelled?
No. Apple keeps the subscription renewing until you cancel it yourself. Waterm reminds you of this before the purchase and links to subscription management.
How do I get a refund?
Refunds are handled by Apple. Request one at reportaproblem.apple.com.
How do I set up Herdr notifications?
You need Herdr 0.7.5 or later on a macOS or Linux host. Connect to that host through Herdr in Waterm, open the Space menu, choose "Herdr Notification Plugin" and tap "Install". Waterm asks for permission to send notifications, then uploads and installs the plugin over SSH.
To stop one host sending notifications, choose "Uninstall Plugin" for that host. To hide all of them, turn off notifications for Waterm in the Settings app. Your hosts still send events to the relay until you uninstall the plugin from each host or choose "Clear All Data", which revokes the pairing for every host.
How do I connect over Tailscale?
Sign in to Tailscale from Waterm's settings. Install Tailscale on your computer, sign in to the same account and enable SSH; it then appears as a host you can choose. Uploads from the share sheet to Tailscale hosts aren't supported yet.
Which voice input providers can I use?
Apple speech recognition works without setup. To use Doubao or iFlytek, add your own API credentials in Settings → Voice Input; your provider bills you for usage.
How do I delete my data?
"Clear All Data" in Waterm's settings deletes hosts, keys, passwords and other local data, signs out of Tailscale and revokes notification pairing. If you used iCloud Sync, also choose "Delete iCloud Data", because Clear All Data doesn't remove the iCloud copy. See the privacy policy for details.