#7061: Add additional variable to the docker-compose file (default off) to make it work with rootless podman
docs
docker
Cluster:
Docker and Deployment Improvements
Volume mounts now accept an `OPENCLAW_VOLUME_OPTS` variable to append mount flags like `:U`, `:Z`, or `:rw`.
Defaults to empty (no suffix).
This is mainly useful for SELinux-enabled hosts (Fedora, RHEL) where `:Z` is needed for container access to bind mounts or for rootless containers where `:U` is required for UID translation.
<!-- greptile_comment -->
<h2>Greptile Overview</h2>
<h3>Greptile Summary</h3>
This PR adds an `OPENCLAW_VOLUME_OPTS` env var that appends a suffix to `docker-compose.yml` bind mounts (e.g. `:U`, `:Z`) so rootless Podman / SELinux hosts can adjust mount labeling/UID shifting without editing the compose file. It also wires the variable through `docker-setup.sh` into `.env` and adds documentation updates plus a new `PODMAN-ROOTLESS.md` guide.
<h3>Confidence Score: 4/5</h3>
- This PR is low-risk and mostly docs/config changes, with only minor correctness issues in documentation.
- The compose interpolation pattern (`${OPENCLAW_VOLUME_OPTS:-}`) is a standard way to add an optional suffix and should be safe for existing Docker users; changes to `docker-setup.sh` are additive and only export/persist the new variable. Main concern is a docs mismatch (Railway guide mentions a compose-only variable) plus a small typo in the new doc file.
- docs/railway.mdx (doc correctness), PODMAN-ROOTLESS.md (typo)
<!-- greptile_other_comments_section -->
<sub>(2/5) Greptile learns from your feedback when you react with thumbs up/down!</sub>
<!-- /greptile_comment -->
Most Similar PRs
#7709: Using Podman in place of Docker
by juanheyns · 2026-02-03
79.2%
#6698: feat: Add CLI wrapper for Docker integration and update documentation
by barshopen · 2026-02-01
79.2%
#8050: fix: docker hardening
by christopherbarnett96 · 2026-02-03
78.7%
#23313: feat(docker): add optional build-arg OPENCLAW_INSTALL_DOCKER_CLI to...
by zhuxuwei88-bot · 2026-02-22
77.6%
#7133: feat: Automated Docker setup with environment-based configuration
by synetalsolutions · 2026-02-02
77.6%
#9190: feat(docker): Add autonomous container self-restart and runtime pac...
by alexdredmon · 2026-02-05
77.0%
#11915: Docs: Docker + reverse proxy deployment notes and pairing pitfalls
by walshd1 · 2026-02-08
76.6%
#17104: fix(clawdock): include docker-compose.extra.yml in compose commands
by Limitless2023 · 2026-02-15
76.5%
#11553: feat(docker): add sandbox browser service and documentation
by dangphdh · 2026-02-08
76.2%
#13950: fix(docker): add browser sidecar service and health checks
by n24q02m · 2026-02-11
76.2%