Wardterm documentation
Step by step, from the first server to teams, with a page for each error message.
git pull && sudo systemctl restart appPasteRunStart here
Getting started
Install the app, add a server and connect.
Install Wardterm
Download for Mac, App Store for iPhone and iPad, and updates.
Import hosts
Bring in servers, keys, jump hosts and tunnels from ssh config, CSV or .reg files.
Settings
General, Terminal, Keyboard, Sessions and Security, the same on every device.
Servers and connections
Add and edit servers
The fields of a server, Show more, duplicate and delete.
Servers from the cloud
A group that follows the servers of a cloud account, with a read-only key.
Groups and tags
Nested groups that pass on settings, tags and filters.
Jump hosts and proxies
Reach a server through other servers, a SOCKS5 or an HTTP proxy.
Mosh
Sessions that survive network changes and sleep.
Docker containers
See the containers of a server, follow their logs, open a shell and restart them.
Keys and fingerprints
SSH keys
Create or import a key, put it on a server and sign in with it.
Keys on this device
A key made in the secure chip of the device, confirmed with Touch ID or Face ID.
Security keys
A key made on a YubiKey or another FIDO2 key, confirmed with a touch.
Server fingerprints
Check the host key the first time, and what to do when it changes.
Terminal and sessions
Terminal basics
Sessions, the session menu, split panes, the side panel and themes.
Server stats
CPU, memory, disks and network of a server, next to its terminal.
Keyboard and gestures on iPhone and iPad
The key bar with Esc, Ctrl and arrows, gestures and a hardware keyboard.
Keep sessions alive
Sessions that keep running if the connection drops, reconnection, keepalive and Mosh.
Session alerts
A notification when a command ends or an AI tool waits for you.
AI agents
Every AI agent in your sessions, with its question, its controls and a message.
Hide sensitive data in the terminal
Cover passwords, keys and personal data on screen, in shares and recordings.
Commands and Ask
Account and plans
Sign in on a new device
Sign in on a new device without typing anything, or approve it after signing in with your email and password.
Your account
Sign-in, email, two-factor authentication, devices and deleting the account.
Plans and billing
The trial, buying on the website or in the App Store, invoices and cancelling.
Troubleshooting
Troubleshooting
Find the fix from the message you see.
Why is my SSH connection refused?
Nothing answers on the SSH port of the server.
Why does the server not answer (connection timed out)?
The connection waits and nothing comes back.
Why is the server name not found?
The name of the server does not lead to an address.
Why do I get "No route to host" or "Network is unreachable"?
The device has no network, or no way to reach the server.
Why does the app say the server's key changed?
The key differs from the one you saved, so the connection stopped.
Why is my password not accepted?
The server refused the user or the password.
Why is my SSH key not accepted?
The server does not know your public key, or cannot read it.
Why does the connection close right after I sign in?
The login works, then the session ends at once.
Why does Mosh not start?
mosh-server is missing, the locale is wrong or UDP is blocked.
Why do my sessions drop when I leave the app?
On iPhone or iPad, a session in the background can lose its connection.
Why can't I sign in or sync?
The account does not open, or the vault does not sync.
Why is my App Store purchase not active?
You bought Pro in the App Store and the app does not show it.
I forgot my vault password
Get back in with the recovery code, or start over.