This release adds a few interesting changes:

• The dokku logs command now roughly maps to the heroku logs command, and supports most available options.
• Native Microsoft Azure support is now available!
• Quite a few shellcheck issues were fixed thanks to @callahad!
• Experimental debian installation support. Going forward, we will try and make dokku compatible with all systemd installations, as well as investigate dockerfile-based deployment to continue simplifying installation.

Thanks to all our contributors for making this release great!

Install via the bootstrap script:

wget https://raw.githubusercontent.com/dokku/dokku/v0.4.4/bootstrap.sh
sudo DOKKU_TAG=v0.4.4 bash bootstrap.sh

Bug Fixes

• #1606: @josegonzalez Install plugn 0.2.0 in Makefile installs
• #1643: @Flink Fix generated nginx config when NO_VHOST=1
• #1644: @mmerickel Watch dokku events through a logrotate
• #1647: @callahad Resolve SC2115: 'Use "${var:?}" to ensure this never expands to /'
• #1648: @callahad Resolve SC2154: 'variable is referenced but not assigned'
• #1649: @callahad Resolve SC2164: 'Use cd ... || exit in case cd fails.'
• #1650: @callahad Resolve SC2148: 'target shell is unknown'
• #1651: @callahad Resolve SC2029: 'this expands on client side'
• #1652: @callahad Resolve SC2143: 'Instead of [ -n $(foo | grep bar) ], use foo | grep -q bar'
• #1653: @callahad Resolve SC2145: 'Argument mixes string and array.'
• #1655: @callahad Resolve SC2162: 'read without -r mangles backslashes'
• #1656: @callahad Resolve SC2001: 'See if you can use ${var//search/replace} instead'
• #1660: @callahad Fixup debian/control for Debian
• #1662: @xadh00m Only return users of group 'adm'

New Features

• #1607: @josegonzalez Dokku support for Debian Jessie installation
• #1610: @kdomanski Add post-stop plugn trigger
• #1612: @Flink Add multiple options to the logs plugin
• #1613: @kdomanski Add ps:restore to start applications which weren't manually stopped
• #1628: @michaelshobbs Move RESTORE variable to DOKKU_APP namespace
• #1634: @callahad Allow installation of bats via homebrew
• #1645: @rvalyi Add ability to access git repo via ssh
• #1664: @michaelshobbs Add $REV to pre-receive-app call

Documentation

• #1605: @josegonzalez Make commented output a bit more readable
• #1621: @josegonzalez Document --force option for :destroy commands
• #1623: @sedouard Add Azure Documentation
• #1624: @u2mejc Add trace to help output
• #1626: @josegonzalez Add official dokku-copy-files-to-image plugin
• #1630: @adamwolf Enabling tracing is actually 'dokku trace on'
• #1633: @elia Add a warning regarding the use of trace on
• #1635: @callahad Remove deprecated Linode stackscript
• #1657: @kimausloos Various small doc updates

This release was mainly a documentation release/bugfix.

One major removal was is that as of 0.4.3, we no longer restart containers automatically on failure via docker. This feature was introduced in 0.4.0, and caused issues with duplicate containers being started on server reboot. Until the docker api for container restarts stabilizes, we will not be able to provide this functionality within Dokku.

If desired, you may replicate this functionality using the official docker-options plugin.

Install via the bootstrap script:

wget https://raw.githubusercontent.com/dokku/dokku/v0.4.3/bootstrap.sh
sudo DOKKU_TAG=v0.4.3 bash bootstrap.sh

Bug Fixes

• #1560: @darklow Fixes issue where SSL and non-SSL templates cannot be used at the same time
• #1566: @michaelshobbs Fix logic error in enabling nginx
• #1568: @josegonzalez Remove 'connection closed' messages from dokku ssh client
• #1574: @josegonzalez Ensure the user has a valid hostname set during installation
• #1585: @michaelshobbs Ensure dokku can read nginx logs and don't remove other perms
• #1589: @michaelshobbs Patch broken nginx 1.8.0 logrotate script
• #1591: @michaelshobbs Remove docker restart policy until the docker api stabilizes
• #1603: @josegonzalez Add missing plugin triggers
  Quiet client #1568

New Features

• #1490: @vijayviji Add windows-specific vagrant setup
• #1563: @kdomanski Cleanup all dead containers in dokku cleanup
• #1590: @michaelshobbs Trigger docker-args-build for dockerfile deployments
• #1600: @josegonzalez Upgrade to Herokuish 0.3.4
• #1602: @josegonzalez Add pre-receive-app plugin trigger

Documentation

• #1556: @josegonzalez Use proper cdn link for css asset
• #1557: @josegonzalez Code styling changes
• #1561: @josegonzalez Set dokku-acl compatibility to 0.4.0+
• #1562: @josegonzalez Documentation Overhaul
• #1573: @mateusortiz Add link to license
• #1577: @Flink Add official redirect plugin
• #1587: @josegonzalez Update "reporting other issues" to include docker inspect
• #1598: @adamwolf Add missing bootstrap.sh step
• #1599: @ssd532 Fix a few grammatical mistakes
• #1601: @ojacquemart Fix typo
• #1604: @josegonzalez Add every type of favicon to all templates

This release was mainly a documentation release, with a few notable features:

• You can now use the commercial version of docker-engine with dokku.
• You can now name your containers using the official named-containers plugin

Huge thanks to @Flink for working on our official plugins and adding official basic auth, couchdb, and site maintenance plugins!

Install via the bootstrap script:

wget https://raw.githubusercontent.com/dokku/dokku/v0.4.2/bootstrap.sh
sudo DOKKU_TAG=v0.4.2 bash bootstrap.sh

Bug Fixes

• #1530: @Flink Fix nginx configuration for SSL

New Features

• #1515: @leonardodino Allow local prebuilt stack sourcing
• #1536 #1537: @josegonzalez Add docker-engine-cs as docker-engine alternative
• #1511: @Flink Add named-containers as a core plugin

Documentation

• #1520: @kimausloos Add dokku command-prefix to plugin:install command
• #1519: @3onyc Fix typos in documentation
• #1521: @edm00se Use correct url to bootstrap.sh in README.md
• #1522: @josegonzalez Avoid redirects and use raw.githubusercontent.com for github links
• #1523 #1548: @callahad Make room for the longer bootstrap.sh URL
• #1524: @callahad Document idiosyncracies with Linode
• #1529: @pzula Adds helpful information regarding whitespacing when setting config
• #1525 #1550: @josegonzalez Add gratipay shield to readme
• #1544 #1545 #1547 #1551: @josegonzalez @Flink Update compatibility for community plugins
• #1546: @josegonzalez Add missing description to history output in HISTORY.md
• #1552 #1553 #1555: @josegonzalez Various documentation styling tweaks

This release is primarily a bugfix and documentation update. In 0.4.0, we incorrectly handled setting environment variables in certain cases, resulting in misconfigured applications. We recommend that all users upgrade from 0.4.1 as soon as possible.

One new feature is colorized logging output, which should make it easier to debug application logging output when deploying multiple processes.

Install via the bootstrap script:

wget https://raw.githubusercontent.com/dokku/dokku/v0.4.1/bootstrap.sh
sudo DOKKU_TAG=v0.4.1 bash bootstrap.sh

Bug Fixes

• #1494: @callahad Correctly install packages for DOKKU_TAG=v0.4.0
• #1496: @callahad Don't prompt users when installing dokku package
• #1514: @michaelshobbs Do not use exit 0 in config functions and fix CURL environment variable setting

New Features

• #1482: @Flink Strip the dokku- part from plugins on install
• #1500: @jazzzz Log user name and fingerprint in events
• #1512: @Flink Colorize output from logs

Documentation

• #1485: @matto1990 Update Slack plugin compatability
• #1488: @josegonzalez Update plugins list with compatibility changes
• #1491: @josegonzalez Promote maintenance and http basic auth plugins to official status
• #1492: @josegonzalez Upgrade hostname plugin to 0.4.0+ compatibility
• #1501: @josegonzalez Clarify bootstrap installation documentation
• #1502: @josegonzalez Update dokku-apt compatibility
• #1504: @michaelshobbs Change plugin install doc to show one-step method

This is our first minor release in almost a year. Many new features and removals have occurred, so here is a neat summary:

• Plugins are now triggered via plugn. Notably, you'll need add a plugin.toml to describe the plugin as well as use plugn trigger instead of pluginhook to trigger plugin callbacks. Please see the plugin creation documentation for more details.
• A few new official plugins have been added to the core, including image tagging, certificate management, a tar-based deploy solution, and much more. Check out the New Features section for more details.
• We've removed a few deprecated plugin callbacks. Please see the plugin triggers documentation to see what is available.
• Official datastorage plugins have been created for the most commonly used datastores. If you previously used/maintained a community contributed plugin, please check these out. We'll be adding more official plugins as time goes on.

If you are coming from a previous release, please run the following command to install the latest docker version first (otherwise you will be pegged to docker 1.6.2):

curl -sSL https://get.docker.com/ | sh

Thanks to the many contributors for making this release our best release so far, and special thanks to both @michaelshobbs and @Flink for pushing along the 0.4.0 release!

Install via the bootstrap script:

wget https://raw.githubusercontent.com/dokku/dokku/v0.4.0/bootstrap.sh
sudo DOKKU_TAG=v0.4.0 bash bootstrap.sh

Deprecations and Removals

• #1372: @SonicHedgehog Do no longer force-install a default nginx.conf
• #1415: @tilgovi Remove uses of (un)set-norestart
• #1432: @josegonzalez Delete unmaintained AUTHORS file
• #1450: @michaelshobbs Rename event plugin buildstep hooks to buildpack

Bug Fixes

• #1344: @AdamVig Add better error checking on nginx:import-ssl
• #1417: @josegonzalez Expose host and port in vagrant build vm
• #1418: @josegonzalez Use cgroupfs-mount as alternative package to cgroup-lite dependency
• #1419: @u2mejc Fix dokku ps over ssh
• #1422: @josegonzalez Guard against missing VHOST files when listing domains
• #1428: @jimeh Use $PLUGIN_PATH instead of $(dirname $0)/..
• #1430: @lubert Update vagrant box name to bento/ubuntu-14.04
• #1439: @michaelshobbs Fix tar tests by sleeping for 5 seconds
• #1447: @alanjds Properly detect app name in the official cli client
• #1449: @josegonzalez Match herokuish deb with released version number
• #1457: @lukechilds Bashstyle fixes
• #1463: @josegonzalez Update Xenify Distro option for linode stackscript
• #1464: @josegonzalez Limit number of log lines when calling dokku logs -t
• #1466: @josegonzalez Follow bashstyle conventions where possible
• #1471: @michaelshobbs Make the default scaling logic clearer
• #1475: @josegonzalez Fix issue where restart on failure option overrode existing DOCKER_ARGS

New features

• #1225: @michaelshobbs Add tags plugin to handle image tagging and deployment of tagged app images
• #1228: @michaelshobbs Use plugn instead of pluginhook to trigger plugin hooks
• #1402: @josegonzalez Consolidate configuration management into config plugin
• #1414: @michaelshobbs Add certs plugin for certificate management
• #1420: @josegonzalez Add dokku enter for connecting to an app container
• #1421: @basicer Add tar plugin to manage tar-based deployments
• #1423: @josegonzalez Set DYNO_TYPE_NUMBER environment variable for each container
• #1431: @josegonzalez Add helper function for inspecting the state of a container
• #1444: @josegonzalez Extract cleanup command into common function
• #1445: @josegonzalez Create CONTRIBUTING.md
• #1455: @michaelshobbs Continue and log an event if/when container retirement fails
• #1458: @michaelshobbs Set Herokuish TRACE=true when DOKKU_TRACE is set
• #1460: @michaelshobbs Bump herokuish version to 0.3.3
• #1465: @josegonzalez Set DYNO environment variable to heroku-compatible value
• #1467: @josegonzalez Upgrade dokku installation to use docker-engine
• #1468: @michaelshobbs Clean up semver logic and run install-dependencies after package installation
• #1469: @isundaylee Add nginx:access-logs and nginx:error-logs commands
• #1470: @assaf Add nginx configuration for running behind load balancer
• #1472: @michaelshobbs Use processes defined in Procfile when generating DOKKU_SCALE file
• #1473: @josegonzalez Handle crashing containers by using restart=on-failure policy
• #1476: @michaelshobbs Support static nginx port when deploying without an application VHOST
• #1476: nginx proxy without VHOST
• #1477: @arthurschreiber Support removing config variables that contain \n.

Documentation

• #1407: @ertrzyiks Correct DOKKU_DOCKERFILE_PORT variable name in docs
• #1408: @josegonzalez Add links to official dokku datastorage plugins
• #1426: @henrik Update memcached link to maintained fork
• #1437: @Flink Update compatibility version for several plugins
• #1446: @johnfraney Correct nginx documentation
• #1478: @eljojo Fix naming of herokuish package in installation docs

This release has a few new features, the largest of which is switching from buildstep to herokuish for building containers. Going forward, this should help ensure that built containers are as close to heroku containers as possible, and also allow us to be on the cutting edge of heroku buildpack support. Props to @michaelshobbs for his work on herokuish.

Install via the bootstrap script:

wget https://raw.githubusercontent.com/progrium/dokku/v0.3.26/bootstrap.sh
sudo DOKKU_TAG=v0.3.26 bash bootstrap.sh

Bug Fixes

• #1401: @josegonzalez Install apt-transport-https before adding https-backed apt sources

New Features

• #1128: @michaelshobbs Switch from buildstep to herokuish
• #1399: @basicer Make dokku play nice when there are multiple receive-app hooks
• #1413: @michaelshobbs support comments in DOKKU_SCALE and print contents on deploy

Documentation

• #1400: @josegonzalez Fix HISTORY.md formatting
• #1410: @josegonzalez Clarify DOKKU_SCALE usage
• #1411: @josegonzalez Clarify ps:scale example

This release is a bugfix release fixing a broken 0.3.25 apt-get installation. Big thanks to @jimeh for quickly spotting the issue!

Install via the bootstrap script:

wget https://raw.githubusercontent.com/progrium/dokku/v0.3.25/bootstrap.sh
sudo DOKKU_TAG=v0.3.25 bash bootstrap.sh

Bug Fixes

• #1398 @josegonzalez Revert "Remove dokku plugins-install from postinst hook

This release is a bugfix release covering dokku packaging.

This release is broken

Bug Fixes

• #1397: @josegonzalez Use https docker apt repo
• #1394: @josegonzalez Remove dokku plugins-install from postinst hook

Docs Changes

• #1395: @adrianmoya Adding fqdn requirement

This release is a bugfix release mostly covering installation and nginx issues. As well, we launched a nicer documentation site here. Thanks to all of our contributors for making this a great release!

Install via the bootstrap script:

wget https://raw.githubusercontent.com/progrium/dokku/v0.3.23/bootstrap.sh
sudo DOKKU_TAG=v0.3.23 bash bootstrap.sh

Bug Fixes

• #1334: @josegonzalez Fix pluginhook building and update package version
• #1335: @josegonzalez Fix name for michaelshobbs
• #1341: @michaelshobbs Honor $DOKKU_DOCKERFILE_PORT when binding the docker container to an external IP.
• #1357: @michaelshobbs only run domains and nginx config if we have a port and ip
• #1366: @omeid Make bootstrap.sh safe from bad connection
• #1370: @SamuelMarks Switch from /dev/null to -qq, from --silent to -sL, and sudo
• #1380: @emdantrim Removed uses of sudo from bootstrap.sh
• #1383: @michaelshobbs fix downscaling from 10+

New Features

• #1292: @michaelshobbs use column to format help output
• #1337: @josegonzalez Update PREBUILT_STACK_URL to latest buildstep release
• #1354: @alessio Log receive-branch pluginhook
• #1359: @michaelshobbs allow DOKKU_WAIT_TO_RETIRE to be defined per app
• #1365: @michaelshobbs support dockerfile images that don't include bash

Docs Changes

• #1305: @josegonzalez Updated documentation site
• #1321: @fwolfst Mention alternative to nginx.conf templates: include-dir.
• #1346: @michaelshobbs document dokku cleanup and the potential of compat issues
• #1349: @alexkruegger add plugin dokku-app-configfiles
• #1358: @bkniffler Add suggestion for low memory VMs
• #1377: @vkurup Fix link to docs from README
• #1379: @jezdez Deleted old, unmaintained plugins
• #1381: @lunohodov Instructions for using the bash client in shells other than bash

This release is a general bugfix release, with improvements to handling of nginx templates and application configuration.

Install via the bootstrap script:

wget https://raw.githubusercontent.com/progrium/dokku/v0.3.22/bootstrap.sh
sudo DOKKU_TAG=v0.3.22 bash bootstrap.sh

Bug Fixes

• #825: @andrewsomething Add support for multiple keys in the installer.
• #1274: @michaelshobbs Parse correct section of path for dokku ls container type
• #1289: @michaelshobbs Do not background container cleanup
• #1298: @SonicHedgehog Fix check-deploy skipping the root path
• #1300: @michaelshobbs Fix urls command when NO_VHOST=1
• #1310: @michaelshobbs Use config:get for checks skipping variables
• #1311: @michaelshobbs Ignore protocol of Dockerfile EXPOSE (refs: #1280)
• #1312: @michaelshobbs Use docker inspect fordefault container check. Closes #1270
• #1313: @michaelshobbs Verify we have an app when deploy is called. Closes #1309
• #1319: @MWers Spelling fix: 'comma seperated'=>'comma-separated'
• #1331: @alexkruegger Fix retrieval of nginx.conf.template app

New Features

• #1149: @mlebkowski Add pluginhook to receive branches different than master
• #1254: @kilianc Add DOKKU_DOCKERFILE_START_CMD support
• #1261: @Flink Add the ability to skip checks (all or default)
• #1277: @krokhale Add gzip to nginx templates by default
• #1278: @assaf Add the ability to retrieve nginx template from app
• #1291: @michaelshobbs Refactored interface for managing global/local app configuration
• #1299: @SonicHedgehog Set X-Forwarded-Proto header if TLS is enabled when running checks

Docs Changes

• #1273: @alessio Add docs for the events plugin
• #1276: @josegonzalez Reorder and deprecate a few plugins
• #1279: @josegonzalez Add docs for receive-branch hook. Refs #1149
• #1282: @josegonzalez Move primecache to deprecated plugins
• #1285: @josegonzalez Rename dokku-events-logs.md according to index.md
• #1296: @Flink Add docker-auto-volumes to plugins
• #1301: @mixxorz Add reset mtime plugin list
• #1302: @fwolfst Mention where original nginx templates are found by default.
• #1306: @josegonzalez Clarify web/cli installation docs. Closes #1177. Closes #1170
• #1307: @josegonzalez Add release documentation. Closes #1287
• #1324: @michaelshobbs Update docs to reflect default checks