Files
dokku/docs/appendices/0.38.0-migration-guide.md
Jose Diaz-Gonzalez 20f2100d46 docs: add 0.38.0 migration guide with nginx.conf.sigil update notes
Custom nginx.conf.sigil templates that reference DOKKU_APP_WEB_LISTENERS
may now receive an empty value when rendered for apps without running web
processes. The migration guide documents how to handle this with a
conditional in the template.
2026-04-24 02:54:22 -04:00

1.1 KiB

0.38.0 Migration Guide

Changes

  • Dokku now generates a minimal nginx configuration for apps without running web processes (undeployed apps, apps with no web process type, or apps with stopped web processes). This configuration returns 502 Bad Gateway responses, ensuring the app's domain resolves and monitoring tools can detect non-200 status codes. The configuration is automatically replaced with the full proxy configuration once the app is deployed with running web processes. See the nginx documentation for more details.
  • Users with custom nginx.conf.sigil templates that reference DOKKU_APP_WEB_LISTENERS should be aware that this variable may now be empty when the template is rendered for apps without running web processes. Custom templates should handle this case gracefully, for example by using a conditional to serve an error page instead of proxying:
    location / {
    {{ if $.DOKKU_APP_WEB_LISTENERS }}
      proxy_pass  http://{{ $.APP }}-{{ $upstream_port }};
    {{ else }}
      return 502;
    {{ end }}
    }