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


gems (8) Versions 1.0.2

Sets up a local gem server repository or mirror

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

gems Cookbook

Build Status Cookbook Version

Sets up a local gem server repository.



  • Ubuntu / Debian


  • apache2
  • rsync


  • 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 and Author

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

rsync >= 0.0.0
apache2 >= 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.

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

Foodcritic Metric

1.0.2 passed this metric