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


htpasswd (25) Versions 1.0.0

Provider for htpasswd

cookbook 'htpasswd', '= 1.0.0', :supermarket
cookbook 'htpasswd', '= 1.0.0'
knife supermarket install htpasswd
knife supermarket download htpasswd
Quality 100%

htpasswd Cookbook

Cookbook Version
Build Status

Manage users in htpasswd files.


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 or come chat with us on the Chef Community Slack in #sous-chefs.



  • CentOS 7+
  • Debian 9+
  • Ubuntu 16.04+ LTS

Chef Infra

This cookbook requires Chef Infra >= 14.




  • :add: Add a login in a htpasswd file. Update and modify it if there is already one and create file if not found (default)
  • :overwrite: Overwrite an htpasswd file (delete file and add user) NOTE: This action is not idempotent.
  • :delete: Delete a login in a htpasswd file.


  • :file: Path of the htpasswd to manage
  • :user: User to create
  • :password: Password for the user
  • :type: Password algorithm to use. Valid options are: "md5", "bcrypt", "sha1", "plaintext", or "crypt". Default is "md5"
  • :mode: File mode for the file. Default is 0640.


# add user "foo" with password "bar" to "/etc/nginx/htpassword" with the default md5 type.
htpasswd "/etc/nginx/htpassword" do
  user "foo"
  password "bar"

# add user "foo" with password "bar" using sha1 as the type.
htpasswd "/etc/nginx/htpassword" do
  user "foo"
  password "bar"
  type "sha1"

# add user "foo" with encrypted password using plaintext as the type.
htpasswd "/etc/nginx/htpassword" do
  user "foo"
  password "$apr1$H5Z8CUB.$L3wyxUF1ZDd.oZFlTkJ4X."
  type "plaintext"


This project exists thanks to all the people who contribute.


Thank you to all our backers!


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

htpasswd Cookbook Changelog

This file is used to list changes made in each version of the htpasswd cookbook.

1.0.0 - 2020-09-28


  • Automated PR: Cookstyle Changes #39
  • Automated PR: Standardising Files #38
  • Fix converge failures on Chef 16
  • Fix idempotency for :add and :delete actions
  • Fix htauth gem loading issues


  • Support for 'plaintext' type #32
  • Adoption by Sous-Chefs #40
  • Add delete and overwrite test-kitchen suites
  • Add mode parameters for file


  • Update test-kitchen to modern platforms
  • Update metadata.rb for Sous Chefs
  • Update for Sous Chefs
  • Convert htpasswd to a custom resource


  • Remove unused recipes and other dependencies

0.3.0 - 2017-05-21

  • Tests #30
  • Fix FC069, FC071, FC078 #26
  • Update testing #25
  • Switch from python to poise-python #24
  • Update attribute default.rb #22
  • Drop ruby 1.9.3 #20
  • Add default package to packages attribute #19
  • Fix Jenkins URL to match github repo #18

0.2.4 - 2014-09-23

  • Remove ruby dep (very old and unmaintained) (fixed #15)
  • Fix rubocop
  • Update rubocop

0.2.2 - 2014-09-17

  • Cleanup provider init
  • Add why-run

0.2.0 - 2014-09-17

  • Add matchers for chefspec #14
  • Added a new resource type so the hashing algorithm can be changed #13

0.1.2 - 2014-03-14

  • Rubocop #12
  • Fix travis #11
  • Use htauth lib to manage htpasswd files. #10
  • Added :delete action for user #5

0.0.3 - 2013-07-18

  • Berkshelf support

0.0.2 - 2013-07-18

  • Initial release

Collaborator Number Metric

1.0.0 passed this metric

Contributing File Metric

1.0.0 passed this metric

Foodcritic Metric

1.0.0 passed this metric

No Binaries Metric

1.0.0 passed this metric

Testing File Metric

1.0.0 passed this metric

Version Tag Metric

1.0.0 passed this metric