WardtermSSH client
EN
Download

Wardterm documentation

Docker containers

Manage Docker and Podman containers in Wardterm over SSH: Compose projects, live logs, a shell, restart, images, volumes, networks and clean up.

Open Containers

  • Open the menu of a server and choose Containers: touch and hold it on iPhone and iPad, or right-click it on Mac.
  • An SSH terminal also has a Containers tab in its side panel, for the same server, on iPhone too.

The app uses the docker or podman command of the server, over SSH. There is nothing to install. The list stays up to date while it is on screen.

The list

  • Containers are grouped by Compose project, then Other containers. Each one shows its state, its image and its ports.
  • Stopped containers are folded away: a button such as Show 2 stopped brings them back. The search field narrows the list by name.
  • Choose a container to open its page, with Logs, Shell and Restart, or Start when it is stopped.

Logs, shell and actions

  • Logs follows the log of the container live, and stops when you close it.
  • Shell opens a shell inside the container, in a new terminal session.
  • The menu of a container has Logs, Shell, Start or Stop, Restart, Pause or Resume, and Delete. Touch and hold the container on iPhone and iPad, or right-click it on Mac.
  • Stop and Delete ask first. Deleting a container keeps the data in its volumes.

The page of a container

It shows the state, the image, the ports, and bars for CPU and Memory. Show more adds when it was created, its command, when it restarts, its networks, its volumes and folders, and its environment variables. Their values stay hidden until you choose Show values.

Compose projects

The ... button next to the name of a project opens its actions:

  • Logs of all its containers together
  • Open compose file, in the editor of Files
  • Start, Stop and Restart for the whole project
  • Update images: newer images are downloaded, then the containers that changed are recreated. Data in volumes stays.

Stop, Restart and Update images ask first.

Images, volumes and networks

Under More, at the end of the list:

  • Images lists the images, in use or unused. Check for updates asks each registry whether a newer image exists, without downloading it. To update, use Update images on the Compose project.
  • Volumes and Networks list what the server holds, and which ones are unused.
  • An unused image, volume or network can be deleted, after a question. Deleting a volume deletes its data for good.

Clean up

  1. Under More, choose Clean up.
  2. Each line says how much space it frees: Stopped containers, Unused images, Unused volumes, Unused networks and Build cache.
  3. Choose what to delete. The button shows the space it frees, such as Clean up 1.2 GB: choose it and confirm once.

To see the same space on the server:

docker system df

Permissions and sudo

When the user of the server cannot use Docker, the app says This user can't use Docker. If sudo works without a password, the app uses it by itself. Otherwise:

  1. Choose Use sudo.
  2. Type the sudo password of the user.

You can also add the user to the docker group, then sign in again.

sudo usermod -aG docker $USER

Vaults you can only view

For a server in a shared vault where you have Can view, Containers shows View only: you see the containers, their pages and their logs, without the actions. See Shared vaults.