Wardterm documentation

Add and edit servers

Add a server in Wardterm: address, user and login, then Show more for protocol, jump servers, terminal and startup. Duplicate, delete and restore servers.

Add a server

  1. On Mac and iPad, open Servers and choose New server. On iPhone, open the Vaults tab, then Servers, then + and New server.
  2. Fill in Address: an IP address or a host name.
  3. Optional: a Name for the list, a Group and Tags, separated by commas.
  4. Check the Port (22 for SSH) and fill in the User.
  5. Add a Password, or choose a Key or a saved login. Left empty, the app asks when you connect.
  6. Choose Connect.

The same server in an OpenSSH config file:

Host web1
  HostName 203.0.113.10
  User deploy
  Port 22

To bring in many servers at once, see Import hosts and Servers from the cloud.

Find devices on your network

On a new server, the Wi-Fi button in the Address field opens Find on this network…. It lists the computers and devices near you that offer SSH. Choose one to fill in its address.

Connect without saving

Type ssh deploy@203.0.113.10 or deploy@203.0.113.10 -p 2222 in the filter at the top of the Servers list. On Mac press Return; on iPhone tap Connect to and the address. The connection appears in the Connection log, where Save as server keeps it.

Show more

The form shows the fields used most. Show more opens the rest, in groups. When it is closed, it says how many of these settings you changed.

  • Connection: Protocol (SSH, Telnet, or Serial for a console cable on a Mac), Mosh, Keepalive, and Automatic commands, used for suggestions, which you turn off for routers and switches.
  • Login: Root password, used when a command asks for it, and Agent forwarding.
  • Network and jumps: Jump servers and Proxy, and Key Exchange.
  • Terminal: Theme, Character set, Backspace sends Ctrl+H, and Terminal Type.
  • At startup: Startup command, Environment variables and Agent.
  • Organization: Environment and System.

Environment variables reach the server only if it accepts them. On the server, in /etc/ssh/sshd_config:

AcceptEnv LANG LC_* APP_ENV

Production servers

Set Environment to Production for servers where a mistake costs the most. Before a risky command or a saved command runs there, the app asks Run this on production?. It also asks before opening production servers together, typing to them all at once or pasting several lines. More on the production safety page.

The menu of a server

Touch and hold a server on iPhone and iPad, or right-click it on Mac. The menu is the same everywhere:

  • Connect, Files and Containers: see Containers
  • Edit, Duplicate and Move to group
  • More: Run a command, Active Sessions (see Keep sessions alive), and on Mac Connect in a new window. Then Share with team, when you are in a team, and Send a Copy, which sends a copy of the server to someone by email.
  • Delete, last.

Duplicate, delete and restore

  1. Open the menu of a server.
  2. Choose Duplicate to make a copy named after it, or Delete.
  3. A deleted server goes to the Trash with its saved login. You have 30 days to restore it from Trash, at the end of Vaults in the sidebar.