0.25.0 Migration Guide

Registry Plugin

The dokku-registry plugin is now built-in. This comes with a few changes:

Builder plugins should call post-release-builder at the end of the build.
The push and pull command are not implemented. Users wishing to deploy a remote image should use git:from-image. Image pushing is not available at this time.
At this time, remote docker repositories are not automatically created for AWS, and users must create those repositories for their applications as necessary. This may be implemented in the future.
Docker images are only pushed when configured to do so. See the registry management documentation for more details.

The network plugin can now set an initial-network for all containers on creation. This is a replacement for specifying the --network flag via the docker-options plugin. Please see the network documentation for more information.
The dokku run command now always removes the ephemeral container on exit. Users that need a persistent container should instead specify a console process type in their Procfile specifying an available shell (usually either bash or sh) and scale that container appropriately.

In previous versions of Dokku, the only way to specify a custom Dockerfile was to use the docker-options plugin to set the --file flag for a docker build. As of 0.25.0, the builder-dockerfile:set command should be used instead, as outlined in the docs here. Usage of the old method should be migrated to the new method.
The --rm and ``--rm-containerflags may be specified but no longer have any effect ondokku run`.
The --detach flag is deprecated in favor of the run:detached command.
The DOKKU_SCALE file is deprecated. Please see the process management documentation for more information on it's replacement with the formations key of the app.json file.
The hooks post-release-buildpack, post-release-dockerfile, and post-release-pack are deprecated in favor of post-release-builder. See the plugin triggers documentation for more details.

As of April 2021, Ubuntu 16.04 is no longer an LTS release, and support has been removed. Packages may still install on older versions of Ubuntu, but are no longer tested, and therefore no support will be provided.