podman-compose

a script to run docker-compose.yml using podman

Github stars Tracking Chart

Podman Compose

An implementation of docker-compose with podman backend.
The main objective of this project is to be able to run docker-compose.yml unmodified and rootless.
This project is aimed to provide drop-in replacement for docker-compose,
and it's very useful for certain cases because:

  • can run rootless
  • only depend on podman and Python3 and PyYAML
  • no daemon, no setup.
  • can be used by developers to run single-machine containerized stacks using single familiar YAML file

For production-like single-machine containerized environment consider

For the real thing (multi-node clusters) check any production
OpenShift/Kubernetes distribution like OKD.

NOTE

This project is still underdevelopment.

Installation

Install latest stable version from PyPI:

pip3 install podman-compose

pass --user to install inside regular user home without being root.

Or latest development version from GitHub:

pip3 install https://github.com/containers/podman-compose/archive/devel.tar.gz

or

curl -o /usr/local/bin/podman-compose https://raw.githubusercontent.com/containers/podman-compose/devel/podman_compose.py
chmod +x /usr/local/bin/podman-compose

or

curl -o ~/.local/bin/podman-compose https://raw.githubusercontent.com/containers/podman-compose/devel/podman_compose.py
chmod +x ~/.local/bin/podman-compose

or install from Fedora (starting from f31) repositories:

sudo dnf install podman-compose

Basic Usage

We have included fully functional sample stacks inside examples/ directory.

A quick example would be

cd examples/busybox
podman-compose --help
podman-compose up --help
podman-compose up

A more rich example can be found in examples/awx3
which have

  • A Postgres Database
  • RabbitMQ server
  • MemCached server
  • a django web server
  • a django tasks

When testing the AWX3 example, if you got errors just wait for db migrations to end.

Tests

Inside tests/ directory we have many useless docker-compose stacks
that are meant to test as much cases as we can to make sure we are compatible

How it works

The default mapping 1podfw creates a single pod and attach all containers to
its network namespace so that all containers talk via localhost.
For more information see docs/Mappings.md.

If you are running as root, you might use identity mapping.

Main metrics

Overview
Name With Ownercontainers/podman-compose
Primary LanguagePython
Program languagePython (Language Count: 4)
Platform
License:GNU General Public License v2.0
所有者活动
Created At2019-03-04 08:52:30
Pushed At2025-07-07 14:30:09
Last Commit At
Release Count13
Last Release Namev1.5.0 (Posted on 2025-07-07 17:13:00)
First Release Namev0.1.5 (Posted on 2019-09-03 18:42:58)
用户参与
Stargazers Count5.6k
Watchers Count46
Fork Count530
Commits Count1.1k
Has Issues Enabled
Issues Count742
Issue Open Count328
Pull Requests Count359
Pull Requests Open Count14
Pull Requests Close Count120
项目设置
Has Wiki Enabled
Is Archived
Is Fork
Is Locked
Is Mirror
Is Private