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


gems (20) Versions 2.0.4

Sets up a local gem server repository or mirror

cookbook 'gems', '= 2.0.4', :supermarket
cookbook 'gems', '= 2.0.4'
knife supermarket install gems
knife supermarket download gems
Quality 100%

gems Cookbook

Build Status Cookbook Version

Sets up a local gem server repository.



  • Ubuntu / Debian


  • apache2
  • rsync


  • Chef 12.15+


  • gem_server['virtual_host_name'] - ServerName for Apache vhost. Default 'gems.domain'.
  • gem_server['virtual_host_alias'] - ServerAlias(es) for Apache vhost. Default 'gems'.
  • gem_server['directory'] - Filesystem location for the repository, default is /srv/gems.


Create files/default/packages, and copy gems to that directory.

Specify the gem source on clients via the command line, for example:

sudo gem source -a http://gems
sudo gem install rails --source http://gems

Or use the source with gem_package resources in your chef recipes.

gem_package "rails" do
  source "http://gems"

Use the gems::mirror recipe to mirror RubyForge. This will take a long time because the repository is 28k+ gems and over 5.5G. It will also override the remote_directory resource to not notify gem generate_index, and instead handle that in the cron job that does the rsync.

License & Authors

Author:: Joshua Timberman

Copyright:: 2009-2015, Chef Software, Inc

Licensed under the Apache License, Version 2.0 (the "License");
you may not use this file except in compliance with the License.
You may obtain a copy of the License at

Unless required by applicable law or agreed to in writing, software
distributed under the License is distributed on an "AS IS" BASIS,
See the License for the specific language governing permissions and
limitations under the License.

Dependent cookbooks

apache2 >= 0.0.0
rsync >= 0.0.0

Contingent cookbooks

There are no cookbooks that are contingent upon this one.

gems Cookbook CHANGELOG

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

2.0.4 - 2021-06-01

  • resolved cookstyle error: metadata.rb:11:1 refactor: ChefStyle/OverlyComplexSupportsDependsMetadata
  • resolved cookstyle error: metadata.rb:17:1 refactor: ChefModernize/RespondToInMetadata

2.0.3 (2018-05-26)

  • Properly mock out the distro in the ChefSpec
  • Add a test cookbook to update apt / install ruby
  • Use full file modes on directories
  • Update the platforms we test on to include new Debian/Ubuntu releases

2.0.2 (2017-04-26)

  • Add a warning when applying the empty gems default recipe
  • Chef 13 attribute fix

2.0.1 (2017-04-26)

  • Convert Travis integration testing to kitchen-dokken
  • Improve Chefspec output
  • Fix file modes to be strings
  • Test with Local Delivery and not Rake
  • Move templates out of the default directory since only Chef < 12 requires this

2.0.0 (2016-09-16)

  • Testing updates
  • Require Chef 12.1

v1.0.2 (2015-10-20)

  • Fix a typo in a notification that prevented the cookbook from compling
  • Updated the supported Ubuntu released in the readme
  • Update test kitchen config to test the server install

v1.0.1 (2015-10-20)

  • Converted readme to MD for rendering on the Supermarket
  • Added source_url and issues_url to the metadata
  • Added name to the metadata for Chef 12
  • Added Berksfile
  • Added gitignore file
  • Add Test Kitchen config
  • Added chefignore file
  • Added Chef standard rubocop config
  • Added Travis CI testing
  • Added Gemfile with the latest testing deps
  • Updated testing and contributing docs
  • Added and maintainers.toml files
  • Added travis and cookbook version badges to the readme
  • Resolved Rubocop and Foodcritic warnings
  • Updated Opscode -> Chef Software

Collaborator Number Metric

2.0.4 passed this metric

Contributing File Metric

2.0.4 passed this metric

Foodcritic Metric

2.0.4 passed this metric

No Binaries Metric

2.0.4 passed this metric

Testing File Metric

2.0.4 passed this metric

Version Tag Metric

2.0.4 passed this metric