Skip to main content

Podman Compose with Podman Desktop


Podman Compose is a community-driven tool that allows developers to use the Compose spec to run many containers at the same time. Podman Compose requires a Compose YAML file with definitions about the containers that need to communicate.

If you have not used a Compose file or the Compose spec, visit this guide for more information.


Getting started

Spin up your compose.yaml with the podman-compose binary and Podman Desktop will automatically detect it!

Use the Flask Redis project from the awesome-compose repository as an example project.

  1. Git clone the project and cd into the directory:

    $ git clone
    $ cd awesome-compose/redis-flask
  2. Run the podman-compose command:

    $ podman-compose -f compose.yaml up -d


  3. Manage Compose with Podman Desktop

    To confirm if the containers are running, open Podman Desktop and click on the ‘Containers’ option on the left side of the application. You will have the containers bundled together under a Pod named flask-redis (compose) in this case. Here, the compose within the bracket indicates it has been generated from a Compose YAML file.


  4. You can further configure or work with these containers within the Podman Desktop application now that they are visible. Here, clicking on the ‘Open Browser’ button allows us to confirm if the application is running expectedly.


  5. You can do much more such as checking logs, opening the terminal or inspecting the files for more details.