https://github.com/marhkb/pods
Keep track of your podman containers
https://github.com/marhkb/pods
gnome gtk4 gtk4-rs libadwaita linux podman rust
Last synced: 9 months ago
JSON representation
Keep track of your podman containers
- Host: GitHub
- URL: https://github.com/marhkb/pods
- Owner: marhkb
- License: gpl-3.0
- Created: 2022-02-06T00:49:26.000Z (about 4 years ago)
- Default Branch: main
- Last Pushed: 2025-03-26T07:22:09.000Z (11 months ago)
- Last Synced: 2025-04-13T22:39:39.673Z (10 months ago)
- Topics: gnome, gtk4, gtk4-rs, libadwaita, linux, podman, rust
- Language: Rust
- Homepage:
- Size: 12.4 MB
- Stars: 811
- Watchers: 12
- Forks: 20
- Open Issues: 36
-
Metadata Files:
- Readme: README.md
- License: COPYING
- Code of conduct: CODE_OF_CONDUCT.md
Awesome Lists containing this project
- fucking-Awesome-Linux-Software - 
Pods
Manage your Podman containers
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.
## 🔌 Installation
Install Pods from flathub by issuing
```shell
flatpak install com.github.marhkb.Pods
```
Pods can be kept up to date by issuing flatpak's update command like
```shell
flatpak update
```
You can also grab the latest CI build from [here](https://nightly.link/marhkb/pods/workflows/ci/main).
Then you need to unzip the archive's content and install the application with the command `flatpak install pods.flatpak`.
Keep in mind that you have to manually repeat this procedure to update the application.
## 🏗️ 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](https://flathub.org/apps/details/org.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 >= 0.59
- ninja
- appstream-glib (for checks)
- cargo
- glib2 >= 2.66
- gtk4 >= 4.18
- libadwaita >= 1.7
- gtksourceview > 4.90
- vte-2.91-gtk4 >= 0.70
#### Build Instruction
```shell
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](https://hosted.weblate.org/engage/pods/) platform.
## 👨💻️ Code of Conduct
We adhere to the [GNOME Code of Conduct](/CODE_OF_CONDUCT.md) and expect all communications within this project to comply with it.
## 💝 Acknowledgment
The library [podman-api-rs](https://github.com/vv9k/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](https://github.com/SeaDve), from whom I took the [gettext](https://github.com/SeaDve/scripts/blob/0bd6f162ec8f2b3f0a9ad12816477fed934077db/gettext_rs.py) python script and whose projects like [Kooha](https://github.com/SeaDve/Kooha) and [Mousai](https://github.com/SeaDve/Mousai) served as inspiration for the README.
And also, a warm thank you to all the [contributors](https://github.com/marhkb/pods/graphs/contributors)
and [translators](https://hosted.weblate.org/engage/pods/) from Weblate.