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

Select Status

The stackstorm cookbook has been deprecated

Author provided reason for deprecation:

The stackstorm cookbook has been deprecated and is no longer being maintained by its authors. Use of the stackstorm cookbook is no longer recommended.


stackstorm (12) Versions 0.6.0

Installs/Configures stackstorm

cookbook 'stackstorm', '~> 0.6.0', :supermarket
cookbook 'stackstorm', '~> 0.6.0'
knife supermarket install stackstorm
knife supermarket download stackstorm
Quality 50%

StackStorm Chef Cookbook

Build Status
Chef cookbook at Supermarket
Join our community Slack

Cookbook to install and configure StackStorm components using Chef.

StackStorm is event-driven automation platform written in Python.
With over 100+ integrations like GitHub, Docker, Nagios, NewRelic, AWS, Chef, Slack it allows you to wire together existing infrastructure into complex Workflows with auto-remediation and many more.
Aka IFTTT orchestration for Ops.

Supported Platforms

  • Ubuntu 14.04 LTS
  • RHEL7 / CentOS7


Minimum 2GB of memory and 3.5GB of disk space is required, since StackStorm is shipped with RabbitMQ, PostgreSQL, Mongo and OpenStack Mistral workflow engine. See System Requirements for production use.

Quick Start

For those who want to play with StackStorm, a recipe already exists to get you setup and going with minimal effort:



Installs and configures st2.
Mind that the valid config options must be provided such as RabbitMQ and MongoDB endpoints.
Otherwise StackStorm services fail when trying to establish connections.


All-in-one solution which installs and configures st2 system services as well as all required dependencies such as RabbitMQ, MongoDB, st2mistral, Nginx and st2web.


Installs StackStorm Web UI control panel (st2web) and configures nginx as a proxy for StackStorm services.
It will generate self-signed certificate by default, see Install WebUI and setup SSL termination.


Common attributes

Key Type Description Default
['stackstorm']['config'] Hash Various options used to build up the st2.conf configuration file. see [config.rb](attributes/config.rb)
['stackstorm']['username'] String StackStorm username for simple htpasswd-based authentication. st2admin
['stackstorm']['password'] String StackStorm password. Ch@ngeMe

System User

To run local and remote shell actions, StackStorm uses a special system user (default stanley). For remote Linux actions, SSH is used. It is advised to configure SSH key-based authentication on all remote hosts.

Key Type Description Default
['stackstorm']['user']['user'] String System user used by stackstorm stack. stanley
['stackstorm']['user']['group'] String System group used by stackstorm stack. stanley
['stackstorm']['user']['home'] String Path to stanley's home directory. /home/stanley
['stackstorm']['user']['authorized_keys'] Array List of ssh public keys added to stanley's ~/.ssh/authorized_keys file. []
['stackstorm']['user']['ssh_key'] String Stanley's ssh private key. nil
['stackstorm']['user']['ssh_pub'] String Stanley's ssh public key. nil
['stackstorm']['user']['ssh_key_bits'] Integer Specifies the number of bits for ssh key creation. 2048
['stackstorm']['user']['enable_sudo'] Boolean Enables sudo privileges for stanley. true

Stanley's ssh key is automatically generated if no ssh_key is provided. If root privileges for running actions are required stanley must be a valid sudoer. This is the default behavior.

Web UI

Settings for StackStorm Web UI st2web and nginx.

Key Type Description Default
['stackstorm']['web']['ssl']['self_signed']['enabled'] Boolean Enable self-signed certificate generation. true
['stackstorm']['web']['ssl']['self_signed']['org'] String Self-signed certificate O field. StackStorm
['stackstorm']['web']['ssl']['self_signed']['org_unit'] String Self-signed certificate OU field. Information Technology
['stackstorm']['web']['ssl']['self_signed']['country'] String Self-signed certificate C field. US


Other Installers

You might be interested in other methods to deploy StackStorm engine:
* Configuration Management
* Ansible Playbooks
* Puppet Module

stackstorm cookbook CHANGELOG

In Development


  • Add new service 'st2scheduler' introduced since st2 'v3.0'


  • Migrate from 'mongodb' to 'sc-mongodb' cookbook for Chef 13+ support
  • Update test kitchen to CentOS 7.5
  • Cleanups and fixes for ST2 2.9 support, and broken Travis builds


  • Update Test kitchen to CentOS 7.2
  • Drop Fedora support. Distro not officially supported by Stackstorm
  • Migrate from 'mongodb' to 'mongodb3' cookbook (mongo 2.6 to mongo 3.2)


  • Remove poise-python


  • (Identical to 0.3.0)


  • Support installing via system packaginpackagingg.


  • Native repository layout support
  • Various fixes, tested on Fedora 20, Centos 70 and Ubuntu 14.04


Initial release of stackstorm cookbook

Collaborator Number Metric

0.6.0 passed this metric

Contributing File Metric

0.6.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

0.6.0 passed this metric

No Binaries Metric

0.6.0 passed this metric

Testing File Metric

0.6.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

0.6.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