Podman-tui TUI for Podman containers

Podman-tui TUI for Podman containers


PkgGoDev Go Report

Terminal user interface for Podman v4.



podman-tui is a terminal user interface for podman v4 (>=4.0.2). It is using podman go bindings to communicate with local or remote podman machine (through SSH).


Building from source (Linux, Windows) or installing packaged versions are detailed in install guide.

PreRun Checks

  • podman.socket service needs to be running on podman machine. The recommended way to start Podman system service in production mode is via systemd socket-activation:

    $ systemctl --user start podman.socket

    See start podman system service for more details.

  • If the SSH key has a passphrase, then you need to set and export CONTAINER_PASSPHRASE=<password> variable.

    $ export CONTAINER_PASSPHRASE=keypass
  • podman-tui uses 256 colors terminal mode on Nix system and standard ANSI colors on Windows system.

Key Bindings

Check podman-tui docs for keyboard mappings.

Code of Conduct

This project is using the Containers Community Code of Conduct


Licensed under the Apache 2.0 license.

Download Source Code

Download ZIP
May 31, 2022