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


nodejs (62) Versions 5.0.0

Installs/Configures node.js

cookbook 'nodejs', '= 5.0.0', :supermarket
cookbook 'nodejs', '= 5.0.0'
knife supermarket install nodejs
knife supermarket download nodejs
Quality 50%


CK Version Build Status Gitter chat

Installs node.js/npm and includes a resource for managing npm packages



  • Debian/Ubuntu
  • RHEL/CentOS/Scientific/Amazon/Oracle
  • openSUSE

Note: Source installs require GCC 4.8+, which is not included on older distro releases


  • Chef 12.14+


  • build-essential
  • ark


Include the nodejs recipe to install node on your system based on the default installation method:

include_recipe "nodejs"

Install methods


Install node from packages:

node['nodejs']['install_method'] = 'package' # Not necessary because it's the default
include_recipe "nodejs"
# Or
include_recipe "nodejs::nodejs_from_package"

By default this will setup deb/rpm repositories from, which include up to date NodeJS packages. If you prefer to use distro provided package you can disable this behavior by setting node['nodejs']['install_repo'] to false.


Install node from official prebuilt binaries:

node['nodejs']['install_method'] = 'binary'
include_recipe "nodejs"

# Or
include_recipe "nodejs::nodejs_from_binary"

# Or set a specific version of nodejs to be installed
node.default['nodejs']['install_method'] = 'binary'
node.default['nodejs']['version'] = '5.9.0'
node.default['nodejs']['binary']['checksum'] = '99c4136cf61761fac5ac57f80544140a3793b63e00a65d4a0e528c9db328bf40'

# Or fetch the binary from your own location
node.default['nodejs']['install_method'] = 'binary'
node.default['nodejs']['binary']['url'] = ''
node.default['nodejs']['binary']['checksum'] = '0bd86f2a39221b532172c7d1acb57f0b0cba88c7b82ea74ba9d1208b9f6f9697'


Install node from sources:

node['nodejs']['install_method'] = 'source'
include_recipe "nodejs"
# Or
include_recipe "nodejs::nodejs_from_source"


Npm is included in nodejs installs by default. By default, we are using it and call it embedded. Adding recipe nodejs::npm assure you to have npm installed and let you choose install method with node['nodejs']['npm']['install_method']

include_recipe "nodejs::npm"

Warning: This recipe will include the nodejs recipe, which by default includes nodejs::nodejs_from_package if you did not set node['nodejs']['install_method'].



note: This resource was previously named nodejs_npm. Calls to that resource name will still function, but cookbooks should be updated for the new npm_package resource name.

npm_package let you install npm packages from various sources:

  • npm registry:

    • name: property :package
    • version: property :version (optional)
  • url: property :url

    • for git use git://{your_repo}
  • from a json (package.json by default): property :json

    • use true for default
    • use a String to specify json file

Packages can be installed globally (by default) or in a directory (by using attribute :path)

You can specify an NPM_TOKEN environment variable for accessing NPM private modules by using attribute :npm_token

You can append more specific options to npm command with attribute :options array :

  • use an array of options (w/ dash), they will be added to npm call.
  • ex: ['--production','--force'] or ['--force-latest']

This LWRP attempts to use vanilla npm as much as possible (no custom wrapper).


npm_package 'express'

npm_package 'async' do
  version '0.6.2'

npm_package 'request' do
  url 'github mikeal/request'

npm_package 'grunt' do
  path '/home/random/grunt'
  json true
  user 'random'

npm_package 'my_private_module' do
  path '/home/random/myproject' # The root path to your project, containing a package.json file
  json true
  npm_token '12345-abcde-e5d4c3b2a1'
  user 'random'
  options ['--production'] # Only install dependencies. Skip devDependencies

[Working Examples](test/cookbooks/nodejs_test/recipes/npm.rb)

Or add packages via attributes (which accept the same attributes as the LWRP above):

"nodejs": {
  "npm_packages": [
      "name": "express"
      "name": "async",
      "version": "0.6.2"
      "name": "request",
      "url": "github mikeal/request"
      "name": "grunt",
      "path": "/home/random/grunt",
      "json": true,
      "user": "random"

License & Authors

Author: Marius Ducea ( Author: Nathan L Smith ( Author: Guilhem Lettron ( Author: Barthelemy Vessemont (

Copyright: 2008-2017, 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

build-essential >= 0.0.0
ark >= 2.0.2

Contingent cookbooks

301 Applicable Versions
appium Applicable Versions
application_nodejs Applicable Versions
azurecli Applicable Versions
base_image Applicable Versions
boilerplate Applicable Versions
cabot Applicable Versions
camo Applicable Versions
cdap Applicable Versions
cloudless-box Applicable Versions
containership Applicable Versions
cube Applicable Versions
docker-etcd-registrator Applicable Versions
dreadnot Applicable Versions
errbit-server Applicable Versions
etherpad Applicable Versions
etherpad-lite Applicable Versions
foreflight_build_agent Applicable Versions
ghost Applicable Versions
ghost-blog Applicable Versions
guardian Applicable Versions
hipache Applicable Versions
hubot Applicable Versions
huginn Applicable Versions
iisnode Applicable Versions
influxdb Applicable Versions
infochimps_statsd Applicable Versions
jenkins_build Applicable Versions
kronia Applicable Versions
lifeguard Applicable Versions
manta Applicable Versions
meteor Applicable Versions
mimo Applicable Versions
modcloth-hubot Applicable Versions
mozilla-firefox-accounts Applicable Versions
mozilla-firefox-sync Applicable Versions
myusa Applicable Versions
newrelic-sysmond-policy Applicable Versions
node-express-chef-quickstart Applicable Versions
nodejs-deploy Applicable Versions
nodestack Applicable Versions
noosfero Applicable Versions
npm Applicable Versions
npm_lazy Applicable Versions
npm_registry Applicable Versions
oc-id Applicable Versions
omakase Applicable Versions
opsworks_ruby Applicable Versions
pa11y Applicable Versions
pita Applicable Versions
pm2 Applicable Versions
prose Applicable Versions
protractor Applicable Versions
railsbox Applicable Versions
razor Applicable Versions
rethinkdb Applicable Versions
rocketchat Applicable Versions
ruby-env-cookbook Applicable Versions
sinopia Applicable Versions
sonos Applicable Versions
statsd Applicable Versions
statsd-centos7 Applicable Versions
strongloop Applicable Versions
supermarket Applicable Versions
tekno-mineos Applicable Versions
treslek Applicable Versions
uchiwa Applicable Versions
uptime Applicable Versions
verdaccio Applicable Versions
webapp Applicable Versions
webhook Applicable Versions
zf2 Applicable Versions

NodeJS Cookbook Changelog

5.0.0 (2017-11-15)

  • nodejs_npm resource has been converted to a custom resource and renamed to npm_package. The existing resource name will continue to function, but over time code should be updated for the new name. This name change has been made so we can eventually merge this resource into the chef-client.
  • compat_resource cookbook dependency has been removed and this cookbook instead requires Chef 12.14 or later
  • Chef 13 compatibility has been resolved
  • The npm_package resource now properly installs packages when the 'package' property is setA
  • Speed up npm operations by only returning a list of the desired package instead of every npm package
  • Speed up source installation by using multipackage install for the dependencies
  • Remove the broken url_valid? helper which didn't work

4.0.0 (2017-07-11)

  • Updated the cookbook to require Chef 12.1+ and the compat_resource cookbook
  • Removed support for io.js which has merged back into the node.js project
  • Removed the dependency on homebrew, yum-epel, and apt cookbooks
  • Added node['nodejs']['manage_node'] attribute to use only cookbook's LWRP (required to manage node by nvm)
  • Updated the default repository URLs to be the 6.X repos
  • Added initial support for Suse and Amazon Linux
  • Improved architecture detection to support aarch64
  • Improved readme with examples for fetching your own binaries
  • Added installation of openssl and xz utilities that are needed for the binary install recipe
  • Updated the cookbook license string to be an SPDX compliant string
  • Set the minimum version of the ark cookbook to 2.0.2 in order to support Suse
  • Updated the default version from 6.9.1 to 6.10.2
  • Switched to Delivery local mode for testing
  • Added Integration testing in Travis CI with kitchen-dokken and ChefDK

3.0.0 (2016-11-02)

  • Updated the default release to the nodejs 6.9.1. This requires C++11 extensions to compile, which are only present in GCC 4.8+. Due to this RHEL 5/6 and Ubuntu 12.04 are not supported if using this version.
  • Switched the download URLs to the .xz packages since the .tar.gz packages are no longer being created
  • Improvements to the readme examples and requirements sections
  • Removed installation of apt-transport-https and instead rely on an apt cookbook that will do the same
  • Fixed the ChefSpec matchers
  • Added Scientific, Oracle, and Amazon as supported distros in the metadata
  • Added chef_version metadata
  • Removed conflicts and suggests metadata which aren't implemented or recommended for use
  • Removed Chef 10 compatibility code
  • Switched Integration testing to Inspec from bats
  • Added the Apache 2.0 license file to the repo
  • Expanded Test Kitchen testing
  • Switched from Rubocop to Cookstyle and resolved all warnings
  • Switched Travis to testing using ChefDK


  • Use HTTPS prefix URLs for node download #98
  • Update NPM symlink when installing from source #105
  • Add support for NPM private modules #107


  • Fix check version
  • Support iojs package install


  • Move npm_packages to his own recipe
  • Fix different race conditions when using direct recipe call
  • Fix npm recipe


  • Fix package recipe


  • Support io.js. Use node['nodejs']['engine'].
  • Add MacOS support via homebrew


  • Add node['nodejs']['keyserver']
  • Update arm checksum
  • Fix npm_packages JSON


  • Use official nodesource repository
  • Add node['nodejs']['npm_packages'] to install npm package with default recipe


  • Travis integration
  • Gems updated
  • Rewrite cookbook dependencies
  • Added complete test-kitchen integration : Rake, rubocop, foodcritic, vagrant, bats testing ...
  • Added NodeJS install_method option (sources, bins or packages)
  • Added NPM install_method option (sources or packages)
  • NPM version can now be chosen independently from nodejs' embedded version
  • Added a nodejs_npm LWRP to manage, install and resolve NPM packages


  • update default versions to the latest: node - v0.10.15 and npm - v1.3.5
  • default to package installation of nodejs on smartos (@wanelo-pair)
  • Add Raspberry pi support (@robertkowalski)


  • implement installation from package on RedHat - (@vaskas)


  • update default version of node to 0.10.13 - and npm - v1.3.4 ([@jodosha][])


  • update default version of node to 0.10.2 - (@bakins)
  • fully migrated to test-kitchen 1.alpha and vagrant 1.1.x/berkshelf 1.3.1


  • update default versions to the latest: node - v0.10.0 and npm - v1.2.14
  • make_thread is now a real attribute - (@ChrisLundquist)


  • rewrite the package install; remove rpm support since there are no longer any packages available anywhere
  • add support to install legacy_packages from ubuntu repo as well as the latest 0.10.x branch (this is default).


  • add support for binary installation method (@JulesAU)


  • unreleased


  • add smartos support for package install (@sax)
  • support to compile with all processors available (default 2 if unknown) - (@ChrisLundquist)
  • moved to platform_family syntax
  • ensure npm recipe honours the 'source' or 'package' setting - (@markbirbeck)
  • updated the default versions to the latest stable node/npm


  • fixed bug that prevented overwritting the node/npm versions (moved the src_urls as local variables instead of attributes) - (@johannesbecker)
  • updated the default versions to the latest node/npm


  • added packages installation support (@smith)

Collaborator Number Metric

5.0.0 passed this metric

Contributing File Metric

5.0.0 failed this metric

Failure: To pass this metric, your cookbook metadata must include a source url, the source url must be in the form of, and your repo must contain a file

Foodcritic Metric

5.0.0 failed this metric

FC122: Use the build_essential resource instead of the recipe: nodejs/recipes/nodejs_from_source.rb:23
Run with Foodcritic Version 14.0.0 with tags metadata,correctness ~FC031 ~FC045 and failure tags any

No Binaries Metric

5.0.0 passed this metric

Testing File Metric

5.0.0 failed this metric

Failure: To pass this metric, your cookbook metadata must include a source url, the source url must be in the form of, and your repo must contain a file

Version Tag Metric

5.0.0 passed this metric