/podman-tui

Podman Terminal UI

Primary LanguageGoApache License 2.0Apache-2.0

podman-tui

License GitHub release (latest SemVer) Go Go Report codecov

Terminal user interface for Podman environment.

Screenshot

Overview

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

Compatibility matrix

Terminal User Interface Podman
release-1.x v5.x.y
release-0.x v4.x.y

Installation

Building from source (Linux, Windows and MacOS) 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 (use "command prompt" application).

Key Bindings

Check podman-tui docs for keyboard mappings.

Code of Conduct

This project is using the Containers Community Code of Conduct

License

Licensed under the Apache 2.0 license.