Skip to content

Fix README docker run port so the API is reachable#188

Merged
rbardaji merged 1 commit into
mainfrom
fix/187-readme-docker-run-port
Jun 5, 2026
Merged

Fix README docker run port so the API is reachable#188
rbardaji merged 1 commit into
mainfrom
fix/187-readme-docker-run-port

Conversation

@rbardaji

@rbardaji rbardaji commented Jun 5, 2026

Copy link
Copy Markdown
Collaborator

Closes #187

Problem

The "Run with Docker" section documented:

docker run -p 8001:8000 --env-file .env rbardaji/ndp-ep-api

The published rbardaji/ndp-ep-api image is the all-in-one build, which serves the app through nginx on container port 80 (nothing listens on 8000 in that image). So mapping the host port to container 8000 connects to nothing, and every verification URL fails even though the container is up and healthy — exactly the failure a user hits when following the README as written.

Changes

  • docker run now maps to :80 (docker run -p 8001:80 ...), with a short note explaining the all-in-one image and its port.
  • "Verify Installation" now also lists the Web UI (/ui/) and the liveness endpoint (/health), and notes that docker compose uses host port 8002 by default (vs 8001 for the docker run example).
  • Version bumped to 0.32.2 (swagger_settings.py + CHANGELOG.md).

Testing

Documentation-only change; the only code change is the version string (existing tests mock the version, so none are affected).

The documented `docker run -p 8001:8000 ... rbardaji/ndp-ep-api` mapped to
container port 8000, but the published all-in-one image serves the app through
nginx on port 80, so following the README verbatim left the API unreachable.
Map to :80 and explain the all-in-one image/port. Also list the Web UI and
/health endpoint in "Verify Installation" and note the compose default port.

Closes #187
@rbardaji rbardaji merged commit fab073b into main Jun 5, 2026
1 check passed
@rbardaji rbardaji deleted the fix/187-readme-docker-run-port branch June 5, 2026 12:53
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.

Following the README docker run command leaves the API unreachable

1 participant