Skip to content

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 here
  • 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/myapp on the Dokku server
  • Check out an example template here
  • Support for server-wide SSL certs have been dropped in favor of using the certs plugin
  • dokku certs:add myapp < 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 myapp