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

The kernel_module cookbook has been deprecated

Author provided reason for deprecation:

The kernel_module cookbook has been deprecated and is no longer being maintained by its authors. Use of the kernel_module cookbook is no longer recommended.


kernel_module (5) Versions 1.1.0

Load kernel modules

cookbook 'kernel_module', '= 1.1.0', :supermarket
cookbook 'kernel_module', '= 1.1.0'
knife supermarket install kernel_module
knife supermarket download kernel_module
Quality 100%

kernel_module Cookbook

Build Status Cookbook Version

This cookbook will aid in adding/removing kernel modules from a running system, and ensure they're loaded at system boot.



  • Debian, Ubuntu


  • Chef 12.7+


  • none



This recipe expects node[:kernel_modules] to be of the form:

  raid10: :install,
  raid456: :uninstall,
  ntfs: :blacklist

and performs the actions specified on the modules listed, so you can specify modules to load/unload entirely from a role-file.



  • ['kernel_modules'] - Hash of modules to perform actions on using the default recipe.



This resource allows you to manage kernel modules.


  • :install: loads the module immediately, adds an entry to /etc/modprobe.d to ensure it loads on boot, and updates the initramfs.
  • :uninstall: unloads the module immediately, removes the configuration entry, and updates the initrams.
  • :blacklist: unloads the module immediately, and adds a configuration file to blacklist the module.
  • :load: loads the module immediately.
  • :unload: unloads the module immediately.


Permanently load the zfs module:

kernel_module 'zfs'

Unload just the raid10 module:

kernel_module 'raid10' do
  action :unload


This cookbook is maintained by Chef's Community Cookbook Engineering team. Our goal is to improve cookbook quality and to aid the community in contributing to cookbooks. To learn more about our team, process, and design goals see our team documentation. To learn more about contributing to cookbooks like this see our contributing documentation, or if you have general questions about this cookbook come chat with us in #cookbok-engineering on the Chef Community Slack


Copyright: 2018, Chef Software, Inc.
Copyright: 2016-2018, Shopify, Inc.

Dependent cookbooks

This cookbook has no specified dependencies.

Contingent cookbooks

network_interfaces_v2 Applicable Versions

kernel_module Cookbook CHANGELOG

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

1.1.0 (2018-04-18)

  • This cookbook is now maintained by Chef in the chef-cookbooks org. Thank you Shopify for the initial work and transferring this cookbook here.
  • Resolved failures on Chef 14
  • Improved the not_if / only_if logic used to decide if the module should be loaded. Previously modules would often be detected as loaded when they were not
  • Officially added Debian support in addition to Ubuntu
  • Added initial support for non-Debian platforms
  • Added chef_version metadata with 12.7 as the required version
  • Added issues_url and source_url metadata
  • Add a chefignore file to speed up transfers to/from the Chef server
  • Removed the ChefSpec matchers since ChefSpec now autogenerates matchers
  • Switched from Rake to Delivery Local Mode for testing
  • Remove the specs to the default dir and use Berks
  • Added InSpec tests for the test cookbook

Collaborator Number Metric

1.1.0 passed this metric

Contributing File Metric

1.1.0 passed this metric

Foodcritic Metric

1.1.0 passed this metric

License Metric

1.1.0 passed this metric

No Binaries Metric

1.1.0 passed this metric

Testing File Metric

1.1.0 passed this metric

Version Tag Metric

1.1.0 passed this metric