containers
/
podman-tui
mirror of https://github.com/containers/podman-tui.git
1
0
Fork 0
Code Issues Packages Projects Releases Wiki Activity
podman-tui/docs/install.md

2.7 KiB
Raw Permalink Blame History

Installation Guide

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

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.

$ brew install podman-tui

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
    }
  }
}