podman-tui
podman-tui is a Terminal User Interface to interact with the podman (v3.x).
podman bindings has been used to communicate with podman environment through rest api API (unix socket).
NOTE:
The project is at its early stages and still adding more features and feel free to contribute.
Building From Source
podman-tui is using go v1.17 or above.
-
Clone the repo
-
Build and run the executable
make build && ./bin/podman-tui
PreRun Checks
-
podman-tui use podman unix socket for query therefore
podman.socket
service needs to be running.
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.
-
podman-tui uses 256 colors terminal mode. On `Nix system make sure TERM is set accordingly.
export TERM=xterm-256color
-
podman-tui prefers recent podman version e.g. >= 3.4.2
The Command Line
# turn on debug mode
podman-tui -d
Logs
podman-tui and podman(libpod) do produce logs to podman-tui.log
file. Turn on debug mode for podman-tui in order to view debug level messages as well.
Key Binding
podman-tui uses following keyboard keys for different actions:
Action | Command |
---|---|
To view pods list page | F1 |
To view containers list page | F2 |
To view volumes list page | F3 |
To view images list page | F4 |
To view networks list page | F5 |
To view system page | F6 |
Lunch page command dialog | ctrl-v |
Close a dialog | Esc |