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


s3fs (12) Versions 1.1.0

Mount one or more S3 buckets to the filesystem.

cookbook 's3fs', '= 1.1.0', :supermarket
cookbook 's3fs', '= 1.1.0'
knife supermarket install s3fs
knife supermarket download s3fs
Quality -%

Amazon s3fs Recipe

The purpose of this recipe is to create a s3fs driver for one of your amazon s3 buckets. The cookbook supports using an encrypted data bag to keep data safe in shared situations.


To use, create a data bag per unique s3fs configuration. An example is included. Upload using:

knife data bag from file examples/s3_keys-deploy_key.json

Then, for each node to run this configuration, use a role like this:

"run_list": [
"override_attributes": [
  "s3fs": {
    "data_bag": {
      "name": "s3_keys",
      "item": "deploy_key"

What does it do?

It will install s3fs on your server, then it will create folders in the /mnt directory named the same as each bucket listed in the data bag. Lastly it will create a s3fs mount for each s3 bucket specified in your configuration.

The recipe will handle encrypted data bags, and uses the Chef::EncryptedDataBagItem.load with default decryption key file.

Multi User Support

If you have multiple AWS IAM users with different keys and multiple buckets that need mounted, you can use node['s3fs']['multi_user']. By setting this attribute to true, it will allow you to mount multiple buckets across as many user accounts (with different keys) as you want. Instead of using node["s3fs"]["data_bag"]["item"] to specify which data bag item to load, you create one or more data bags under node["s3fs"]["data_bag"]["name"] for each unique AWS IAM user you need to use. The data bag format is still the same as it always has been.


If you have any problems or change requests to this recipe create an issue or submit a pull request on

Dependent cookbooks

This cookbook has no specified dependencies.

Contingent cookbooks

There are no cookbooks that are contingent upon this one.

No quality metric results found