Wardterm documentation

Groups and tags

Organize SSH servers in Wardterm with nested groups that pass their settings on, connect to a whole group at once, and filter the server list by tags.

Create a group

  1. On Mac and iPad, choose the arrow next to New server, then New group. On iPhone, choose +, then New group.
  2. Give it a Name. To put it inside another group, choose a Parent group.
  3. Fill in only what its servers share, such as the user, the key or the port.

What a group passes on

Servers in a group use its settings unless they set their own. What a group leaves empty comes from the group above. A group can pass on:

  • the port, the user and the password or key
  • jump servers, proxy and agent forwarding
  • Mosh and keepalive
  • theme, character set, terminal type and key exchange
  • startup command, environment variables, Agent and Environment.

For example, a group named Production with Environment set to Production and a red theme marks every server in it.

Move servers into a group

  • On Mac, drag a server onto a group.
  • On iPhone, touch and hold a server, then drag it.
  • To move several: select them, then choose Move to group.

Open a whole group

  • The menu of a group is the same everywhere: Open group and Connect to all, then New server in this group and Edit group.
  • Under More: Open as workgroup connects to all of them in one window, Run a command on all runs a command on each. A group from a cloud account also has Refresh and its settings. Then Share with team, when you are in a team, and Send a Copy.
  • Delete is last.

See Saved commands for running a command on several servers.

Tags

  1. Write tags in a server's Tags field, separated by commas, such as web, eu.
  2. Choose tags in the row above the list to filter it. With several tags, the list shows the servers that have all of them.
  3. Choose Clear filter to see every server again.

On Mac, Find anything (Cmd+K) also finds servers by tag, such as #web.

View and sort

The View and sort menu shows the list as Tiles or a List, sorts it by name, last connection, date added, environment or address, and groups it by group, environment or tag. Under Show you choose whether the servers inside groups appear in the list too, and on Mac whether This Mac appears.

This Mac

On Mac, This Mac is the first entry of the list: double-click it to open a terminal on your Mac, as Cmd+L does.