/pods

A podman desktop application

Primary LanguageRustGNU General Public License v3.0GPL-3.0

Pods

A Podman desktop application

Translation status CI status


Preview

Pods is a frontend for podman. It uses libadwaita for its user interface and strives to meet the design principles of GNOME.

With Pods you can, among other things:

  • Connect to local and remote Podman instances.
  • Easily overview images, containers and pods.
  • View prepared information about images, containers, and pods.
  • Inspect images, containers and pods.
  • View and search container logs.
  • Monitor processes of containers and pods.
  • Download images and build them using Dockerfiles.
  • Create pods and containers.
  • Control the lifecycle of containers and pods (in bulk) (start, stop, pause, etc.).
  • Delete images, containers, and pods (in bulk).
  • Prune images.
  • Rename containers.

⚡ Disclaimer

Pods is currently under heavy development. So be prepared for missing features and a lot of bugs.

🔌 Installation

The application is available ob Flathub Beta. First, add the the Flathub Beta remote

$ flatpak remote-add --if-not-exists flathub-beta https://flathub.org/beta-repo/flathub-beta.flatpakrepo

Then you can install the application by issuing

$ flatpak install flathub-beta com.github.marhkb.Pods

Pods can be kept up to date by issuing flatpak's update command like

$ flatpak update

You can also grab the latest CI build from here. Then you need to unzip the archive's content and install the application with the command flatpak install pods.flatpak. Keep in mind

🏗️ Building from source

GNOME Builder

GNOME Builder is the environment used for developing this application. It can use Flatpak manifests to create a consistent building and running environment cross-distro. Thus, it is highly recommended you use it.

  1. Download GNOME Builder.
  2. In Builder, click the "Clone Repository" button at the bottom, using https://github.com/marhkb/pods.git as the URL.
  3. Click the build button at the top once the project is loaded.

Meson

Prerequisites

The following packages are required to build Pods:

  • meson
  • ninja
  • appstream-glib (for checks)
  • cargo
  • glib2
  • gtk4
  • libadwaita >= 1.2

Build Instruction

git clone https://github.com/marhkb/pods.git
cd pods
meson _build --prefix=/usr/local
ninja -C _build install

🙌 Help translate Pods

You can help Pods translate into your native language. If you found any typos or think you can improve a translation, you can use the Weblate platform.

💝 Acknowledgment

The library podman-api-rs provides a rust interface to the Podman API. Without this great project, Pods would probably never have come into existence.

I also wanted to thank SeaDve, from whom I took the gettext python script and whose projects like Kooha and Mousai served as inspiration for the README.

And also, a warm thank you to all the contributors and translators from Weblate.