podman-tui

Terminal user interface for Podman environment.

• Overview
• Compatibility Matrix
• Installation
• PreRun Checks
• Key Bindings
• Color Themes
• Code of Conduct
• License

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

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
  

  For non-systemd distributions, the socket can be created using the below command. Add this command to your distro or window manager’s autostart to start the service automatically.

  $ podman system service --time=0
  

  Note: This command creates the socket only for the user who runs it.

  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

podman-tui uses following keyboard keys for different actions:

Color Themes

podman-tui uses its own colors by default. To use your terminal's colors instead, run it with --theme terminal or set PODMAN_TUI_THEME=terminal. podman-tui then follows your terminal's color scheme, light or dark, even if you change it while podman-tui is running. See the color theme guide for details and screenshots.

Code of Conduct

This project is using the Containers Community Code of Conduct

License

Licensed under the Apache 2.0 license.