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 (3) Versions 0.0.1

Manages a dokku install.

cookbook 'dokku', '= 0.0.1'
cookbook 'dokku', '= 0.0.1', :supermarket
knife cookbook site install dokku
knife cookbook site download dokku
Quality -%


Manages a dokku installation, allowing configuration of application's environment variables and installation of plugins.


These attributes are under the node['dokku'] namespace.

Attribute Description Type Default
stack_url STACK_URL environment variable passed on to Dokku's String nil (meaning it will be whatever is configured on Dokku's Makefile)
domain Domain name to write to /home/git/VHOST String nil (meaning it will be auto detected)
plugins Plugins to install Hash with plugin name as key and GitHub repository URL as value nil

Applications Attributes

These attributes are under the node['dokku']['apps']['YOUR_APP_NAME'] namespace.

Attribute Description Type Default
env Application's environment variables Hash nil


  • recipe[dokku] Installs/Configures Dokku


Default Installation

  • Add recipe[dokku] to your node's run list

After Dokku gets configured, you'll need to upload your SSH key with something like:

$ cat ~/.ssh/ | ssh "sudo gitreceive upload-key some-dokku-user"

Testing and Development


Here's how you can quickly get testing or developing against the cookbook thanks to Vagrant.

vagrant plugin install vagrant-omnibus
git clone git://
cd chef-dokku
vagrant up

You can then SSH into the running VM using the vagrant ssh command.

The VM can easily be stopped and deleted with the vagrant destroy command. Please see the official Vagrant documentation for a more in depth explanation of available commands.


  1. Fork the repository on Github
  2. Create a named feature branch (like add_component_x)
  3. Write you change
  4. Write tests for your change (if applicable)
  5. Run the tests, ensuring they all pass
  6. Submit a Pull Request using Github

Dependent cookbooks

This cookbook has no specified dependencies.

Contingent cookbooks

There are no cookbooks that are contingent upon this one.

No quality metric results found