Skip to content

Fix Podman and Gunicorn compatibility issues on Windows in OCI GenAI Gateway docs#2584

Open
dvlasako wants to merge 1 commit intooracle-devrel:mainfrom
dvlasako:patch-2
Open

Fix Podman and Gunicorn compatibility issues on Windows in OCI GenAI Gateway docs#2584
dvlasako wants to merge 1 commit intooracle-devrel:mainfrom
dvlasako:patch-2

Conversation

@dvlasako
Copy link
Collaborator

  1. Podman Volume Mount (Issue 1): Updated the podman run command to include a note on using absolute Windows paths for ~/.oci mounting, as Unix-style paths don't work reliably in Podman on Windows (requires shared/mounted directories in the Podman VM).

  2. Gunicorn on Windows (Issue 2): Added a note under the production setup clarifying that Gunicorn is Linux-only and recommending alternatives like Uvicorn with PM2 or NSSM for Windows production scaling.

  3. Base URL for Podman on Windows (Issue 3): Changed the recommended Base URL in n8n config from host.docker.internal (unreliable in Podman) to host.containers.internal, with fallbacks to localhost or explicit IP via --add-host for better cross-platform support.

…Gateway docs

1. Podman Volume Mount (Issue 1): Updated the podman run command to include a note on using absolute Windows paths for ~/.oci mounting, as Unix-style paths don't work reliably in Podman on Windows (requires shared/mounted directories in the Podman VM).

2. Gunicorn on Windows (Issue 2): Added a note under the production setup clarifying that Gunicorn is Linux-only and recommending alternatives like Uvicorn with PM2 or NSSM for Windows production scaling.

3. Base URL for Podman on Windows (Issue 3): Changed the recommended Base URL in n8n config from host.docker.internal (unreliable in Podman) to host.containers.internal, with fallbacks to localhost or explicit IP via --add-host for better cross-platform support.
@oracle-contributor-agreement oracle-contributor-agreement bot added the OCA Verified All contributors have signed the Oracle Contributor Agreement. label Feb 20, 2026
@dvlasako dvlasako requested a review from brnil6 February 23, 2026 09:08
@dvlasako dvlasako added the documentation Improvements or additions to documentation label Feb 23, 2026
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

documentation Improvements or additions to documentation OCA Verified All contributors have signed the Oracle Contributor Agreement.

Projects

None yet

Development

Successfully merging this pull request may close these issues.

1 participant