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

Terminal User Interface	Podman
release-2.x	v6.x.y
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

  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:

Action	Key
Display command menu	m
Display sort menu	s
Switch to next screen	l
Switch to previous screen	h
Move up	k
Move down	j
Exit application	Ctrl+c
Close the active dialog	Esc
Switch between interface widgets	Tab
Delete selected item	Delete
Move up/down	Up/Down
Previous/Next screen	Left/Right
Scroll Up	Page Up
Scroll Down	Page Down
Display help screen	F1
Display system screen	F2
Display pods screen	F3
Display containers screen	F4
Display volumes screen	F5
Display images screen	F6
Display networks screen	F7
Display secrets screen	F8

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.