Skip to content

feat: add Podman support as alternative to Docker#487

Open
Jounikka1918 wants to merge 1 commit intojanhq:mainfrom
Jounikka1918:feat/podman-support
Open

feat: add Podman support as alternative to Docker#487
Jounikka1918 wants to merge 1 commit intojanhq:mainfrom
Jounikka1918:feat/podman-support

Conversation

@Jounikka1918
Copy link

@Jounikka1918 Jounikka1918 commented Feb 4, 2026

  • Add automatic container engine detection (Docker/Podman) in Makefile
  • Use podman-compose when Podman is detected
  • Add new Makefile targets: engine-info, podman-setup, podman-network, podman-ps, podman-clean, podman-compose-generate
  • Create scripts/gen-podman-compose.py to generate flattened compose file (workaround for podman-compose not supporting 'include' with path objects)
  • Create scripts/podman-build-services.sh to build Go services (workaround for podman-compose not supporting 'additional_contexts')
  • Fix nested env var interpolation for podman-compose compatibility
  • Fix relative volume paths for project root context
  • Add comprehensive Podman setup documentation

Tested with:

  • Podman 5.7.1
  • podman-compose 1.5.0
  • Arch Linux (cgroups v2, rootless mode)

Workflow:

  1. make CONTAINER_ENGINE=podman podman-setup
  2. ./scripts/podman-build-services.sh llm-api media-api mcp-tools
  3. make CONTAINER_ENGINE=podman up-infra
  4. make CONTAINER_ENGINE=podman up-api

Describe Your Changes

  • Adds Podman as an alternative container runtime for users on Fedora, RHEL, CachyOS (Arch Linux), or anyone preferring daemonless containers. Includes workarounds for podman-compose limitations.

Fixes Issues

  • Closes #
  • Closes #

Self Checklist

  • Added relevant comments, esp in complex areas
  • Updated docs (for bug fixes / features)
  • Created issues for follow-up changes or refactoring needed

- Add automatic container engine detection (Docker/Podman) in Makefile
- Use podman-compose when Podman is detected
- Add new Makefile targets: engine-info, podman-setup, podman-network,
  podman-ps, podman-clean, podman-compose-generate
- Create scripts/gen-podman-compose.py to generate flattened compose file
  (workaround for podman-compose not supporting 'include' with path objects)
- Create scripts/podman-build-services.sh to build Go services
  (workaround for podman-compose not supporting 'additional_contexts')
- Fix nested env var interpolation for podman-compose compatibility
- Fix relative volume paths for project root context
- Add comprehensive Podman setup documentation

Tested with:
- Podman 5.7.1
- podman-compose 1.5.0
- Arch Linux (cgroups v2, rootless mode)

Workflow:
1. make CONTAINER_ENGINE=podman podman-setup
2. ./scripts/podman-build-services.sh llm-api media-api mcp-tools
3. make CONTAINER_ENGINE=podman up-infra
4. make CONTAINER_ENGINE=podman up-api
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

None yet

Projects

Status: No status

Development

Successfully merging this pull request may close these issues.

1 participant

Comments