https://github.com/sous-chefs/nginx

Development repository for the nginx cookbook
https://github.com/sous-chefs/nginx

chef chef-cookbook chef-resource hacktoberfest managed-by-terraform nginx

Last synced: 15 days ago
JSON representation

Development repository for the nginx cookbook

• Host: GitHub
• URL: https://github.com/sous-chefs/nginx
• Owner: sous-chefs
• License: apache-2.0
• Created: 2012-03-14T18:35:37.000Z (about 13 years ago)
• Default Branch: main
• Last Pushed: 2025-04-01T09:17:00.000Z (about 2 months ago)
• Last Synced: 2025-05-07T10:33:47.694Z (23 days ago)
• Topics: chef, chef-cookbook, chef-resource, hacktoberfest, managed-by-terraform, nginx
• Language: Ruby
• Homepage: https://supermarket.chef.io/cookbooks/nginx
• Size: 1.68 MB
• Stars: 550
• Watchers: 72
• Forks: 802
• Open Issues: 5
• Metadata Files:
  • Readme: README.md
  • Changelog: CHANGELOG.md
  • Contributing: CONTRIBUTING.md
  • License: LICENSE
  • Code of conduct: CODE_OF_CONDUCT.md
  • Codeowners: .github/CODEOWNERS

Awesome Lists containing this project

README

        
# nginx Cookbook

[![Cookbook Version](https://img.shields.io/cookbook/v/nginx.svg)](https://supermarket.chef.io/cookbooks/nginx)

[![CI State](https://github.com/sous-chefs/nginx/workflows/ci/badge.svg)](https://github.com/sous-chefs/nginx/actions?query=workflow%3Aci)

[![OpenCollective](https://opencollective.com/sous-chefs/backers/badge.svg)](#backers)

[![OpenCollective](https://opencollective.com/sous-chefs/sponsors/badge.svg)](#sponsors)

[![License](https://img.shields.io/badge/License-Apache%202.0-green.svg)](https://opensource.org/licenses/Apache-2.0)

Installs nginx from package and sets up configuration handling similar to Debian's Apache2 scripts.

## Maintainers

This cookbook is maintained by the Sous Chefs. The Sous Chefs are a community of Chef cookbook maintainers working together to maintain important cookbooks. If you’d like to know more please visit [sous-chefs.org](https://sous-chefs.org/) or come chat with us on the Chef Community Slack in [#sous-chefs](https://chefcommunity.slack.com/messages/C2V7B88SF).

## Requirements

### Cookbooks

The following cookbooks are direct dependencies because they're used for common "default" functionality.

- `ohai` for setting up the ohai plugin

### Platforms

The following platforms are supported and tested with Test Kitchen:

- AlmaLinux 8/9

- Rocky Linux 8/9

- CentOS Stream 8/9

- Amazon Linux 2023

- Debian 11/12

- Ubuntu 22.04/24.04

### Chef

- Chef 15.3+

## Resources

- [nginx_install](documentation/nginx_install.md)

- [nginx_config](documentation/nginx_config.md)

- [nginx_site](documentation/nginx_site.md)

- [nginx_service](documentation/nginx_service.md)

## Usage

This cookbook is now resource-based. Use the resources described above in wrapper cookbooks or recipes.

## Contributors

This project exists thanks to all the people who [contribute.](https://opencollective.com/sous-chefs/contributors.svg?width=890&button=false)

### Backers

Thank you to all our backers!

![https://opencollective.com/sous-chefs#backers](https://opencollective.com/sous-chefs/backers.svg?width=600&avatarHeight=40)

### Sponsors

Support this project by becoming a sponsor. Your logo will show up here with a link to your website.

![https://opencollective.com/sous-chefs/sponsor/0/website](https://opencollective.com/sous-chefs/sponsor/0/avatar.svg?avatarHeight=100)

![https://opencollective.com/sous-chefs/sponsor/1/website](https://opencollective.com/sous-chefs/sponsor/1/avatar.svg?avatarHeight=100)

![https://opencollective.com/sous-chefs/sponsor/2/website](https://opencollective.com/sous-chefs/sponsor/2/avatar.svg?avatarHeight=100)

![https://opencollective.com/sous-chefs/sponsor/3/website](https://opencollective.com/sous-chefs/sponsor/3/avatar.svg?avatarHeight=100)

![https://opencollective.com/sous-chefs/sponsor/4/website](https://opencollective.com/sous-chefs/sponsor/4/avatar.svg?avatarHeight=100)

![https://opencollective.com/sous-chefs/sponsor/5/website](https://opencollective.com/sous-chefs/sponsor/5/avatar.svg?avatarHeight=100)

![https://opencollective.com/sous-chefs/sponsor/6/website](https://opencollective.com/sous-chefs/sponsor/6/avatar.svg?avatarHeight=100)

![https://opencollective.com/sous-chefs/sponsor/7/website](https://opencollective.com/sous-chefs/sponsor/7/avatar.svg?avatarHeight=100)

![https://opencollective.com/sous-chefs/sponsor/8/website](https://opencollective.com/sous-chefs/sponsor/8/avatar.svg?avatarHeight=100)

![https://opencollective.com/sous-chefs/sponsor/9/website](https://opencollective.com/sous-chefs/sponsor/9/avatar.svg?avatarHeight=100)