Awesome Podman Pods

A curated list of Podman Pods samples.

These samples provide a starting point for how to integrate different services using kube.yaml manifest and to manage their deployment with podman kube play or in any kubernetes environment.

Note The following samples are intended for use in local development environments such as project setups, tinkering with software stacks, etc. These samples must not be deployed in production environments.

Contents

• Samples of Podman Pods applications with multiple integrated services.
• Single service samples.
• Basic setups for different platforms (not production ready - useful for personal use).
• Getting started.

Samples of Podman Pods applications with multiple integrated services

Icon indicates Sample is compatible with Podman+Wasm.

• ASP.NET / MS-SQL - Sample ASP.NET core application with MS SQL server database.
• Elasticsearch / Logstash / Kibana - Sample Elasticsearch, Logstash, and Kibana stack.
• Go / NGINX / MySQL - Sample Go application with an Nginx proxy and a MySQL database.
• Go / NGINX / PostgreSQL - Sample Go application with an Nginx proxy and a PostgreSQL database.
• Java Spark / MySQL - Sample Java application and a MySQL database.
• NGINX / ASP.NET / MySQL - Sample Nginx reverse proxy with an C# backend using ASP.NET.
• NGINX / Flask / MongoDB - Sample Python/Flask application with Nginx proxy and a Mongo database.
• NGINX / Flask / MySQL - Sample Python/Flask application with an Nginx proxy and a MySQL database.
• NGINX / Node.js / Redis - Sample Node.js application with Nginx proxy and a Redis database.
• NGINX / Go - Sample Nginx proxy with a Go backend.
• NGINX / WSGI / Flask - Sample Nginx reverse proxy with a Flask backend using WSGI.
• PostgreSQL / pgAdmin - Sample setup for postgreSQL database with pgAdmin web interface.
• Python / Flask / Redis - Sample Python/Flask and a Redis database.
• React / Spring / MySQL - Sample React application with a Spring backend and a MySQL database.
• React / Express / MySQL - Sample React application with a Node.js backend and a MySQL database.
• React / Express / MongoDB - Sample React application with a Node.js backend and a Mongo database.
• React / Rust / PostgreSQL - Sample React application with a Rust backend and a Postgres database.
• React / Nginx - Sample React application with Nginx.
• Spring / PostgreSQL - Sample Java application with Spring framework and a Postgres database.
• WasmEdge / MySQL / Nginx - Sample Wasm-based web application with a static HTML frontend, using a MySQL (MariaDB) database. The frontend connects to a Wasm microservice written in Rust, that runs using the WasmEdge runtime. 
• WasmEdge / Kafka / MySQL - Sample Wasm-based microservice that subscribes to a Kafka (Redpanda) queue topic, and transforms and saves any incoming message into a MySQL (MariaDB) database. 

Single service samples

• Angular
• Spark
• VueJS
• Flask
• PHP
• Traefik
• Django
• Minecraft server
• Plex
• Portainer
• Wireguard
• FastAPI

Basic setups for different platforms (not production ready - useful for personal use)

• Gitea / PostgreSQL
• Nextcloud / PostgreSQL
• Nextcloud / Redis / MariaDB
• Pi-hole / cloudflared - Sample Pi-hole setup with use of DoH cloudflared service
• Prometheus / Grafana
• Wordpress / MySQL

Getting started

These instructions will get you through the bootstrap phase of creating and deploying samples of containerized applications with Podman Pods.

Prerequisites

• Make sure that you have Podman or Podman Desktop installed
  • Windows or macOS: Install Podman Desktop
  • Linux: Install Podman and then podman-compose
• Download some or all of the samples from this repository.

Running a sample

The root directory of each sample contains the compose.yaml from awesome-compose, and corresponding kube.yaml manifest. The latter file can be run in any numerous kubernetes distributions or within podman pod. All samples can be run in a local environment by going into the root directory of each one and executing:

podman kube play kube.yaml
podman ps -ap

Check the README.md of each sample to get more details on the structure and what is the expected output. To stop and remove all containers of the sample application run:

podman pod stop pod_name
podman pod rm pod_name

Quickstart guides

In addition to all the ready to run Compose samples listed above the folder official-documentation-samples contains quickstart guides. Each of these step by step guides explain which files need to be created to build and run a Podman Pods application.

Contribute

We welcome examples that help people understand how to use Podman Pods for common applications. Check the Contribution Guide for more details.