Adoptable Cookbooks List

Looking for a cookbook to adopt? You can now see a list of cookbooks available for adoption!
List of Adoptable Cookbooks

Supermarket Belongs to the Community

Supermarket belongs to the community. While Chef has the responsibility to keep it running and be stewards of its functionality, what it does and how it works is driven by the community. The chef/supermarket repository will continue to be where development of the Supermarket application takes place. Come be part of shaping the direction of Supermarket by opening issues and pull requests or by joining us on the Chef Mailing List.

Select Badges

Select Supported Platforms


dokku (4) Versions 2.2.0

Manages a dokku install.

cookbook 'dokku', '~> 2.2.0'
cookbook 'dokku', '~> 2.2.0', :supermarket
knife supermarket install dokku
knife supermarket download dokku
Quality 38%


Build Status

This is a Chef cookbook which provides the ability to install and configure dokku. It provides a set of recipes and Lightweight Resource Providers (LWRPs) for managing apps and it's components.

It's pinned against a specific version of dokku to protect your installation against being accidentally broken. This marks a hold against the installed packages.



  • dokku::default: Includes install and provides the LWRPs.
  • dokku::install: Installs and configures dokku from the Debian package.
  • dokku::ssh_keys: Adds SSH keys from attributes.
  • dokku::plugins: Manages plugins from attributes.
  • dokku::apps: Manages apps from attributes.
  • dokku::certificates: Manages certificates from a data bag.



  • node["dokku"]["domain"]: The domain for Dokku to serve under.
  • node["dokku"]["ssh_keys"]: A list of ssh keys to allow for deployment.
  • node["dokku"]["plugins"]: A list of plugins to manage.
  • node["dokku"]["apps"]: A list of apps to manage.

These optional settings can be overridden to customise the default Nginx configuration (which is used for all apps):

  • node["dokku"]["nginx"]["server_tokens"]: Defaults to off.
  • node["dokku"]["nginx"]["ssl_session_cache"]: Defaults to shared:SSL:20m.
  • node["dokku"]["nginx"]["ssl_session_timeout"]: Defaults to 10m.
  • node["dokku"]["nginx"]["ssl_protocols"]: Defaults to TLSv1 TLSv1.1 TLSv1.2.
  • node["dokku"]["nginx"]["ssl_ciphers"]: Defaults to EECDH+AESGCM:EDH+AESGCM:AES256+EECDH:AES256+EDH.
  • node["dokku"]["nginx"]["dhparam_file"]: Defaults to /etc/ssl/certs/dhparam.pem.
  • node["dokku"]["nginx"]["dhparam_key_length"]: Defaults to 4096.

Data Bags


Used in combination with the dokku::certificates recipe, these allow for the management of SSL certificates apps. It's expected that they look like this:

  "id": "app-name",
  "cert": "",

The id value should be the name of the app the certificate will set on. (The format is inspired by the certificate cookbook.)



Provides add and remove actions for setting the Dokku SSH public keys. Defaults to add. e.g.:

dokku_ssh_key "user" do
  key "ssh_public_key"


Provides install and uninstall actions for handling plugins. Defaults to install. e.g.:

dokku_plugin "redis" do
  url ""


Provides create, destroy and rename actions for managing Dokku apps. Defaults to create. e.g.:

dokku_app "demo"


Provides add and remove actions for managing Dokku certificates. Defaults to add: e.g.:

dokku_certificate "wildcard" do
  cert "An SSL Certificate as a string"
  key "An SSL Certificate's private key as a string"

The name of the action should be the id of an available data bag item.


ChefSpec is used for unit tests. Test Kitchen is used for integration tests, with serverspec.

# unit tests
chef exec rspec
# integration tests chef exec verify


Copyright (c) Nick Charlton 2015. MIT licensed.

Dependent cookbooks

openssl ~> 8.5.5
packagecloud ~> 1.0.0
docker ~> 4.6.5
apt ~> 7.1.0

Contingent cookbooks

There are no cookbooks that are contingent upon this one.


2.2.0 (02/12/2018)

  • Updated cookbook and test dependencies. (PR #20)

2.1.0 (31/05/2016)

  • Remove duplicate nginx configuration, breaking deploys.

2.0.0 (17/05/2016)

  • Check that SSH keys do not already exist before adding. (PR #16)
  • Remove support for global certificates. (PR #17)
  • Upgrade dokku to 0.5.6.
  • Upgrade herokuish to 0.3.12.
  • Upgrade sshcommand to 0.4.0.

1.3.0 (14/05/2016)

  • Fixes a bug where deleting apps would fail because it'd return a 1.
  • Adds support for specifying the "committish" of a plugin. (PR #13)
  • Brings the Nginx configuration inline instead of a dependency. (PR #14)

1.2.0 (18/04/2016)

  • Install and mark a hold on specific versions of dokku dependencies to guard against breakages (PR #11)
  • Fix test run issues with Docker (PR #12).

1.1.0 (05/03/2016)

  • Improves the provided SSL ciphers and adds an option for configuring SSL providers.
  • Includes generation of dhparams to safeguard against Weak DH attacks.

1.0.0 (19/02/2016)

  • Initial release.

Collaborator Number Metric

2.2.0 failed this metric

Failure: Cookbook has 1 collaborators. A cookbook must have at least 2 collaborators to pass this metric.

Contributing File Metric

2.2.0 failed this metric

Failure: To pass this metric, your cookbook metadata must include a source url, the source url must be in the form of, and your repo must contain a file

Foodcritic Metric

2.2.0 passed this metric

No Binaries Metric

2.2.0 passed this metric

Publish Metric

2.2.0 passed this metric

Supported Platforms Metric

2.2.0 failed this metric

dokku should declare what platform(s) it supports.

Testing File Metric

2.2.0 failed this metric

Failure: To pass this metric, your cookbook metadata must include a source url, the source url must be in the form of, and your repo must contain a file

Version Tag Metric

2.2.0 failed this metric

Failure: To pass this metric, your cookbook metadata must include a source url, the source url must be in the form of, and your repo must include a tag that matches this cookbook version number