Skip to content

docs: add Podman as alternative container runtime#266

Closed
RomuDeuxfois wants to merge 3 commits intomainfrom
docs/add-podman-as-alternative-container-runtime
Closed

docs: add Podman as alternative container runtime#266
RomuDeuxfois wants to merge 3 commits intomainfrom
docs/add-podman-as-alternative-container-runtime

Conversation

@RomuDeuxfois
Copy link
Member

Summary

Add Podman as a documented alternative to Docker across installation and development guides. Podman is a drop-in, daemonless, rootless replacement for Docker that avoids Docker Desktop licensing constraints.

Context

The existing documentation exclusively references Docker/Docker Desktop for container management. Users and contributors who prefer or require Podman (e.g., due to licensing, security, or organizational policies) had no guidance. This PR adds Podman as a first-class alternative throughout the docs.

Changes

docs/deployment/installation.md

  • Added an informational callout introducing Podman as a Docker alternative
  • Converted Linux and Windows/MacOS prerequisites into tabbed sections (Docker vs. Podman) so users can pick their runtime
  • Added a Podman-specific tip in the "Run OpenAEV" section

docs/development/environment-ubuntu.md

  • Converted the Docker Engine prerequisite into tabbed sections (Docker Engine vs. Podman)
  • Added Podman install instructions and a compatibility note

docs/development/build-from-source.md

  • Added a Podman compatibility tip in the "Required dependencies" section, clarifying that podman compose is a drop-in replacement for docker compose

Notes

  • All existing Docker instructions remain unchanged — Podman is presented as an alternative, not a replacement
  • Linux users can continue using Docker CLI/Engine (no licensing issue)
  • The docker-compose.yml files are fully compatible with Podman

Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

None yet

Projects

None yet

Development

Successfully merging this pull request may close these issues.

1 participant