install.md

Installation Guide

• Building From Source
• Installing on Linux
  • Alpine Linux
  • AlmaLinux, Rocky Linux
  • Arch Linux (AUR)
  • CentOS Stream
  • Fedora
  • Gentoo
  • Nix
  • RHEL
• Installing on Mac
• Installing on Windows
• Container Image
• Configuration Files

Building From Source

podman-tui is using go version >= 1.20.

$ git clone <repository>
$ make binary # Linux
$ make binary-win # Windows
$ make binary-darwin # MacOS

Installing on Linux

Alpine Linux

$ sudo apk add podman-tui

AlmaLinux, Rocky Linux

Enable EPEL repository and then run:

$ sudo dnf -y install podman-tui

Arch Linux (AUR)

$ yay -S podman-tui

CentOS Stream

Enable EPEL repository and then run:

$ sudo dnf -y install podman-tui

Fedora

$ sudo dnf -y install podman-tui

Gentoo

$ sudo emerge app-containers/podman-tui

Nix

$ nix-shell -p podman-tui

RHEL

Enable EPEL repository and then run:

$ sudo dnf -y install podman-tui

Installing on Mac

podman-tui can be obtained through Homebrew package manager or Nix package manager.

$ brew install podman-tui

Installing on Windows

podman-tui can be obtained through WinGet Windows package manager.

NOTE: podman-tui is only supported on Windows PowerShell.

winget install Containers.PodmanTUI

Container image

Pull from quay.io

$ podman run -it --name podman-tui-app \
  -e CONTAINER_PASSPHRASE="<ssh key passphrase>" \
  -v <ssh_keys_dir>:/ssh_keys/:Z \
  --net=host \
  quay.io/navidys/podman-tui:latest # latest release, use develop tag to pull the upstream build

Build image

podman-tui is using go version >= 1.17.

$ git clone <repository>
$ make binary
$ podman build -t podman-tui -f Containerfile
$ podman run -it --name podman-tui-app \
  -e CONTAINER_PASSPHRASE="<ssh key passphrase>" \
  -v <ssh_keys_dir>:/ssh_keys/:Z \
  --net=host \
  podman-tui

Configuration Files

podman-tui.json

~/.config/podman-tui/podman-tui.json

podman-tui.json is the configuration file which specifies local and remotes podman systems connections details.

{
  "connections": {
    "f42node01": {
      "uri": "ssh://navid@f42node01:22/run/user/1000/podman/podman.sock",
      "identity": "/home/navid/.ssh/id_ed25519"
    },
    "fc42node02": {
      "uri": "ssh://navid@f42node02:22/run/user/1000/podman/podman.sock",
      "identity": "/home/navid/.ssh/id_ed25519"
    },
    "localhost": {
      "uri": "unix://run/user/1000/podman/podman.sock",
      "default": true
    }
  }
}