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 chef-server-webapp cookbook has been deprecated

Author provided reason for deprecation:

The chef-server-webapp cookbook has been deprecated and is no longer being maintained by its authors. Use of the chef-server-webapp cookbook is no longer recommended.

You may find that the chef-server cookbook is a suitable alternative.


chef-server-webapp (4) Versions 0.1.3

Configures Omnibus Chef server as an Apache webapp

cookbook 'chef-server-webapp', '~> 0.1.3', :supermarket
cookbook 'chef-server-webapp', '~> 0.1.3'
knife supermarket install chef-server-webapp
knife supermarket download chef-server-webapp
Quality 43%

chef-server-webapp cookbook

This cookbook configures Omnibus Chef server as an Apache webapp. This
makes it possible to host other HTTP services on the same node that
runs Chef server, and makes it easier to unify http configuration
across multiple services.

This cookbook's home is at


  • apache2 cookbook
  • chef-server cookbook version 2.0.0+


Configure node['chef-server']['webapp']['ssl_key_path'] and
node['chef-server']['webapp']['ssl_certificate_path'] to run over
https. You need to get the key & certificate files to the server
earlier in the run list; you may use
for this.

Make sure node['chef-server']['api_fqdn'] contains proper FQDN.

Add recipe[chef-server-webapp] to your run list.


  • chef-server.webapp.backend_https_port -- port to configure omnibus chef server's nginx to listen on; default is 17443
  • chef-server.webapp.ssl_key_path, chef-server.webapp.ssl_certificate_chain_path (optional), and chef-server.webapp.ssl_certificate_path -- HTTPS keys.


  • default -- configures Omnibus chef server as a webapp.


This cookbook works by reconfiguring chef-server's nginx to listen on
a high port number, and by proxying there over https from Apache. This
is not the most efficient way of making it work: we forward https to
https backend (otherwise bookshelf URLs generated by Chef API are
wrong), so there's double encryption, and nginx shouldn't be required
at all - Apache can be configured as the load balancer itself. If this
is a performance issue for you, probably you need to run chef-server
on a separate machine anyway.

Test cases are still a TODO.


Author:: Maciej Pasternacki

Dependent cookbooks

apache2 >= 0.0.0
chef-server >= 2.0.0

Contingent cookbooks

There are no cookbooks that are contingent upon this one.

Collaborator Number Metric

0.1.3 failed this metric

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

Contributing File Metric

0.1.3 passed this metric

Foodcritic Metric

0.1.3 failed this metric

FC064: Ensure issues_url is set in metadata: chef-server-webapp/metadata.rb:1
FC065: Ensure source_url is set in metadata: chef-server-webapp/metadata.rb:1
FC066: Ensure chef_version is set in metadata: chef-server-webapp/metadata.rb:1
FC067: Ensure at least one platform supported in metadata: chef-server-webapp/metadata.rb:1
Run with Foodcritic Version 16.3.0 with tags metadata,correctness ~FC031 ~FC045 and failure tags any

No Binaries Metric

0.1.3 passed this metric

Supported Platforms Metric

0.1.3 failed this metric

chef-server-webapp should declare what platform(s) it supports.

Testing File Metric

0.1.3 passed this metric

Version Tag Metric

0.1.3 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