snazy commented on code in PR #2051: URL: https://github.com/apache/polaris/pull/2051#discussion_r2209279276
########## site/README.md: ########## @@ -35,6 +35,21 @@ Then point your browser to http://localhost:1313/ Then edit files from your IDE - you will see the changes in your browser. When changing the site structure, it is often necessary to restart Hugo - just run `site/bin/run-hugo-in-docker.sh` again. +## Dealing with `--userns and --pod cannot be used together` errors + +The scripts in the `bin/` directory are built to work with both Docker and podman. There are nuances in how +both behave, especially wrt docker/podman-compose. Some local environment specifics require the use of +`podman-compose`, others the use of `docker-compose`. The default behavior is to prefer the `podman` and +`podman-compose` binaries, if those exist and fall back to `docker` and `docker-compose`. Some setups using +podman however require the use of `docker-compose` even if `podman-compose` is installed. This may manifest +in an error message stating that `--userns` and `--pod` cannot be used together. In that case create a file +`.user-settings` in the `site/` folder and add these two lines: +```bash +DOCKER=docker +COMPOSE=docker-compose Review Comment: OTOH, it's an internal "hack", we can change it anytime. -- This is an automated message from the Apache Git Service. To respond to the message, please log on to GitHub and use the URL above to go to the specific comment. To unsubscribe, e-mail: issues-unsubscr...@polaris.apache.org For queries about this service, please contact Infrastructure at: us...@infra.apache.org