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


ngx (16) Versions 1.1.0

Install and configure nginx web server

cookbook 'ngx', '= 1.1.0', :supermarket
cookbook 'ngx', '= 1.1.0'
knife supermarket install ngx
knife supermarket download ngx
Quality 50%

ngx cookbook

Chef cookbook

A cookbook to provide resources to install, configure and run nginx web server. Wraps nginx cookbook.



Install nginx from source, either stable or mainline version (this is specified in node['ngx']['install'] attribute, which defaults to stable).

Additionally, the following attributes may be utilised so as to compile nginx with extra modules/options:
- node['ngx']['with_openssl'] - ngx_http_ssl_module with openssl built from source, default true;
- node['ngx']['with_http2'] - ngx_http_v2_module, default true;
- node['ngx']['with_ipv6'] - IPv6 support, default true;
- node['ngx']['with_ct'] - nginx-ct module, default false;
- node['ngx']['with_headers_more'] - ngx_headers_more module, default false;
- node['ngx']['with_status'] - [ngx_http_stub_status_module](ngx_http_stub_status_module), default false;
- node['ngx']['with_realip'] - ngx_http_realip_module, default false;
- node['ngx']['with_geoip2'] - ngx_http_geoip2_module, default false;
- node['ngx']['with_secure_link'] - ngx_http_secure_link_module, default false;
- node['ngx']['with_njs'] - ngx_http_js_module, default false;
- node['ngx']['with_debug'] - debugging support, default false;
- node['ngx']['with_devel_kit'] - ngx_devel_kit, default false;
- node['ngx']['with_lua'] - ngx_http_lua_module, default false. If set to true, ngx_devel_kit will also be installed.


Run script/bootstrap to install necessary Ruby Gems.

Run script/test to perform KitchenCI tests.


MIT @ Alexander Pyatkin


All notable changes to this project will be documented in this file.

The format is based on Keep a Changelog
and this project adheres to Semantic Versioning.

[1.1.0] - 2018-08-17


  • Update nginx mainline version to 1.15.2.
  • Update njs version to 0.2.3.
  • Update OpenSSL version to 1.1.0i.
  • Update ngx_http_geoip2_module version to 3.0.
  • with_ct option is now false by default.
  • with_headers_more option is now false by default.

[1.0.3] - 2018-08-05


  • Add main_ext log format (suitable for Nginx Amplify agent)

[1.0.2] - 2018-06-15


[1.0.1] - 2018-06-14


  • Add a CHANGELOG file.
  • Add ngx:test recipe so as to verify nginx -V output during Kitchen tests.
  • Support compiling nginx with ngx_devel_kit module.

[1.0.0] - 2018-06-11

First appearance in public.



Collaborator Number Metric

1.1.0 failed this metric

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

Contributing File Metric

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

1.1.0 passed this metric

No Binaries Metric

1.1.0 passed this metric

Testing File Metric

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

1.1.0 passed this metric