Files
dokku/docs/appendices/0.5.0-migration-guide.md
T
Jose Diaz-Gonzalez d9ad3392af chore: update markdownlint-cli to 0.50.0
The table column style rule added since 0.35.0 is disabled, since the docs pad tables loosely rather than aligning every pipe, and the docs are updated for the other rules it now enforces.
2026-10-29 20:35:36 -04:00

1.6 KiB

0.5.0 Migration Guide

nginx-vhosts plugin

  • The nginx-vhosts template language is now sigil
    • No need to escape literal $ characters (or other "bash-isms")
    • Template variables are represented as {{ .VARIABLE_NAME }}
    • A detailed list of template variables can be found in the available template variables documentation
  • A custom nginx-vhosts template must be named nginx.conf.sigil
    • The default path for this custom template is the root of your repo (i.e. /app in the container or WORKDIR if defined in a dockerfile app)
    • Dokku no longer looks for this file in /home/dokku/node-js-app on the Dokku server
    • Check out an example template
  • Support for server-wide SSL certs have been dropped in favor of using the certs plugin
    • dokku certs:add node-js-app < certs.tar
  • All domains for an SSL-enabled app will be redirected to https by default
    • This can be overridden with a custom template
  • Replaced "magic" NO_VHOST variable with domains:enable/disable
  • Simplified zero downtime control
    • checks:enable/disable

Dockerfile apps with exposed ports

  • Dockerfiles with EXPOSE clauses will get all tcp ports proxied by default
    • Note that nginx will proxy the same port numbers to listen publicly
    • UDP ports can be exposed by disabling the nginx proxy with dokku proxy:disable node-js-app