refactor(docker): remove the bundled Traefik reverse proxy#276
Merged
Conversation
rmyndharis
added a commit
that referenced
this pull request
Jun 17, 2026
Strict SemVer for 0.x: breaking changes bump the MINOR (0.3.0), non-breaking fixes/additions stay in 0.2.x; every breaking change carries a⚠️ + migration note. Refresh the release-summary table through v0.2.8, and re-frame v0.3.0 as the next breaking release (deployment simplification #275/#276 + Puppeteer config #265), with SDK/observability noted as incremental themes.
With the API serving both the UI and the API on a single port, the shipped Traefik service was a single-backend passthrough that added no value (it terminated no TLS out of the box). Remove the traefik service, the traefik/ configs, the with-proxy profile, the PROXY_ENABLED/DASHBOARD_PORT env vars, and the traefik-config test. `--profile full` now starts the optional datastores (postgres, redis, minio). For TLS / public exposure, front the API with your own reverse proxy (nginx, Caddy, a cloud load balancer, or a k8s Ingress); see docs/12-troubleshooting-faq.md.
2241b6f to
f2814cc
Compare
This file contains hidden or bidirectional Unicode text that may be interpreted or compiled differently than what appears below. To review, open the file in an editor that reveals hidden Unicode characters.
Learn more about bidirectional Unicode characters
Sign up for free
to join this conversation on GitHub.
Already have an account?
Sign in to comment
Add this suggestion to a batch that can be applied as a single commit.This suggestion is invalid because no changes were made to the code.Suggestions cannot be applied while the pull request is closed.Suggestions cannot be applied while viewing a subset of changes.Only one suggestion per line can be applied in a batch.Add this suggestion to a batch that can be applied as a single commit.Applying suggestions on deleted lines is not supported.You must change the existing code in this line in order to create a valid suggestion.Outdated suggestions cannot be applied.This suggestion has been applied or marked resolved.Suggestions cannot be applied from pending reviews.Suggestions cannot be applied on multi-line comments.Suggestions cannot be applied while the pull request is queued to merge.Suggestion cannot be applied right now. Please check back later.
Summary
With PR1 making the API serve both the UI and the API on a single port, the shipped Traefik service
no longer earns its place. As configured it was a single-backend passthrough - it forwarded one
public port to
openwa-api:2785and terminated no TLS out of the box (thecertificatesResolverwascommented out and
:443was never published). Its original job was to merge two backends (the nginxdashboard + the API) behind one port; that job no longer exists.
This PR removes Traefik entirely. For TLS / public exposure, front the API with your own reverse
proxy - nginx, Caddy, a cloud load balancer, or a k8s Ingress (there is an nginx example in
docs/12-troubleshooting-faq.md).What changed
traefikservice fromdocker-compose.ymland thetraefik/configs(
traefik.yml,dynamic.yml).with-proxyprofile and thePROXY_ENABLED/DASHBOARD_PORTenv vars(and the related
TRAEFIK_ACME_*placeholders).traefik-configregression test (it asserted Traefik's TLS/insecure-dashboard config,which no longer exists).
fullprofile to the optional datastores (postgres,redis,minio). Note:previously
fullonly carried Traefik + the dashboard, so after their removal it would have startednothing - this makes
--profile fullactually mean "all optional services."scripts/openwa.sh: drops the proxy profile toggle; updates the start/stop output.Net change
traefik-configtest, and theproxy plumbing across compose/env/docs.
Breaking changes & migration
with-proxycompose profile and thePROXY_ENABLED/DASHBOARD_PORTenv vars are removed(silently ignored if still set).
--profile fullnow starts the optional datastores (postgres, redis, minio) instead ofTraefik + the dashboard.
its own port; a single-service container is trivially easy to front with any proxy/ingress.
Deliberately left as-is
docs/13-horizontal-scaling.mdkeeps Traefik/Nginx as a load balancer in front of multiple APIreplicas - that is a legitimate scaling use (a different concern from the removed single-backend
passthrough) and is explicitly framed as a future design sketch.
Testing / verification
npm test(434 - two fewer than PR1, the removedtraefik-configspec),npm run test:e2e(9),npm run lint,docker compose config- all green.docker compose --profile full config --services→docker-proxy, openwa-api, postgres, redis, minio.docker compose config --services→docker-proxy, openwa-api(UI served by the API).Notes for reviewers
of users (those who used
--profile with-proxyfor TLS) and is an opinionated removal that can bereviewed/reverted on its own.