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


pxe_dust (20) Versions 2.0.0

Configures local bootstrapping and installing operating systems via PXE booting.

cookbook 'pxe_dust', '= 2.0.0'
cookbook 'pxe_dust', '= 2.0.0', :supermarket
knife supermarket install pxe_dust
knife supermarket download pxe_dust
Quality 100%


This cookbook handles local bootstrapping and PXE booting life cycle with 3 recipes:

  • server: Configures a tftpd server for serving Ubuntu and Debian installers over PXE.
  • installers: Downloads the Chef full stack installers and writes out Chef bootstraps.
  • bootstrap_template: Builds a template for use with knife to take advantage of the locally mirrored content.


Requires Chef 10.12 or later since it now uses the full-chef installer.


Please refer to the [TESTING file]( to see the currently (and passing) tested platforms. The release was tested on: * Ubuntu 12.04 * Ubuntu 14.04 * Debian 6.0-7.1 (have with manual testing)


Required: apache2, tftp

Optional (recommended): apt (for recipe[apt::cacher-ng]).

DO NOT USE chef-client::delete-validator in conjunction with this cookbook, since it uses the validation.pem to help bootstrap new machines.

pxe_dust Data Bag

In order to manage configuration of machines registering themselves with their Chef Server or Chef Software Hosted Chef, we will use the pxe_dust data bag.

% knife data bag create pxe_dust
% knife data bag from file pxe_dust examples/default.json

Here is an example of the default.json:

    "id": "default",
    "platform": "ubuntu",
    "arch": "amd64",
    "version": "14.04",
    "user": {
        "fullname": "Ubuntu",
        "username": "ubuntu",
        "crypted_password": "$6$Trby4Y5R$bi90k7uYY5ImXe5MWGFW9kel2BnMCcYO9EnwngTFIXKG2/nWcLKTJZ3verMFnpFbITI9.eHwZ.HR1UPeKbCAV1"

Any settings provided by the data bag may be overridden by setting ['pxe_dust']['default'] attributes, for example:

node['pxe_dust']['default']['environment'] = 'qa'

Here are currently supported options available for inclusion in the example default.json:

  • platform: OS platform for the installer, (ie. 'ubuntu' or 'debian').
  • arch: Architecture of the netboot.tar.gz to use as the source of pxeboot images, default is 'amd64'.
  • interface: Which interface to install from, default is 'auto'.
  • version: Ubuntu version of the netboot.tar.gz to use as the source of pxeboot images and full stack clients, default is '12.04'.
  • domain: Default domain for nodes, default is none.
  • boot_volume_size: Size of the LVM boot volume to create, default is '30GB'.
  • packages: Additional operating system packages to add to the preseed file, default is none.
  • run_list: Run list for nodes, this value is NOT set as a default and will be passed to all boot types unless explicitly overwritten.
  • environment: Environment for nodes, this value is NOT set as a default and will be passed to all boot types unless explicitly overwritten.
  • netboot_url: URL of the netboot image to use for OS installation.
  • bootstrap: Optional additional bootstrapping configuration. http_proxy: HTTP proxy, default is none. http_proxy_user: HTTP proxy user, default is none. http_proxy_pass: HTTP proxy pass, default is none. https_proxy: HTTPS proxy, default is none.
  • chef: Whether or not to bootstrap the node with Chef, default is 'true'.
  • halt: Whether to wait for user input at end of bootstrap, default is 'false'.
  • user: crypted_password: SHA512 password for the default user, default 'ubuntu'. This may be generated and added to the data bag. fullname: Full name of the default user, default 'Ubuntu'. username: Username of the default user, default 'ubuntu'.
  • root: crypted_password: SHA512 password for the root user, default 'ubuntu'. This is used on Debian since Ubuntu does not have a root.
  • external_preseed: Direct pxeboot clients to an existing (unmanaged by pxe_dust) preseed file.

Additional data bag items may be used to support booting multiple operating systems. Examples of various Ubuntu and Debian installations are included in the examples directory. Important to note is the use of the addresses option to support tftp booting by MAC address (this is currently required for not using the default) and the explicit need for a run_list and/or an environment if one is to be provided.



Sets the URL to the preseed file, architecture, the domain and which interfaces to use.


The preseed file is full of opinions mostly exposed via attributes, you will want to update this. If there is a node providing an apt-cacher-ng caching proxy via recipe[apt::cacher-ng], it is provided in the preseed.cfg. The initial user and password is configured and any additional required packages may be added to the pxe_dust data bag items. The preseed finishes by calling the chef-bootstrap script.

This is the preseed/late_command that bootstraps the node with Chef via the full stack installer.



The default recipe includes recipe pxe_dust::server.


recipe[pxe_dust::server] includes the apache2, tftp::server and pxe_dust::bootstrap_template recipes.

The recipe does the following:

  1. Downloads the proper netboot.tar.gzs to boot from.
  2. Untars them to the ['tftp']['directory'] directory.
  3. Instructs the installer prompt to automatically install.
  4. Passes the URL of the preseed.cfgs to the installer.
  5. Uses the preseed.cfg template to pass in any apt-cacher-ng caching proxies or other additional settings.


Downloads the full stack installers listed in the pxe_dust data bag and writes out the Chef bootstrap templates for the initial chef-client run connecting to the Chef server.


This recipe creates a bootstrap template that uses a local that uses the cached full stack installers from the installers recipe. It may then be downloaded from http://NODE/NODE.erb and put in your .chef/bootstrap/ directory for use with knife. You may also use the http://NODE/ if you want a local, perhaps for use with [](vagrant-omnibus)'s OMNIBUS_INSTALL_URL setting.


Add recipe[pxe_dust::server] to a node's or role's run list. Create the pxe_dust data bag and update the defaults.json item before adding it.

On an Ubuntu system, the password can be generated by installing the mkpasswd package and running:

mkpasswd -m sha-512

The default is the hash of the password ubuntu, if you'd like to test. This must be set in the pxe_dust data bag to a valid sha-512 hash of the password or you will not be able to log in.

This cookbook does provide DHCP recipe.

Side note, for DD-WRT bootp support this forum post was followed. The key syntax was


in the section Additional DNSMasq Options where the IP address is that of the tftpd server we're configuring here and pxelinux.0 is from the netboot tarball.

If you do not need PXE booting, you may still want to use the pxe_dust::installers and pxe_dust::bootstrap_template for bootstrapping nodes (like with LXC or Vagrant).


node['pxe_dust']['chefversion'] the Chef version that pxe_dust should provide, unset by default which downloads latest node['pxe_dust']['dir'] the location where apache will serve pxe_dust content, default is '/var/www/pxe_dust' node['pxe_dust']['default'] attributes that may be used to override any settings provided by the pxe_dust data bag items

License and Author

Author JJ Asghar (
Author Matt Ray (
Author Joshua Timberman
Copyright Copyright (c) 2011-2016, 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, WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied. See the License for the specific language governing permissions and limitations under the License.

Dependent cookbooks

apt >= 0.0.0
tftp >= 0.0.0
apache2 >= 1.6

Contingent cookbooks

There are no cookbooks that are contingent upon this one.


  • Updated test-kitchen to use chef_zero
  • Changed Berksfile to be source
  • Updated location for the chef-full.erb bootstrap template
  • Updated the server_test minitest to look for apache, added serverspec for in.tftp
  • Created examples/pxe_dust/ to have databag for integration testing
  • Updated default.json from the above for 14.04
  • Added serverspec tests for integration testing
  • Other random updates for 14.04 updates
  • Removed 10.04/13.04 support
  • Added dhcpd server recipe


  • yaboot recipe for pxe booting PPC machines
  • added chef data bag attribute to turn off Chef bootstrapping if desired
  • added halt data bag attribute to turn off reboot at end of preseed
  • cleaned up downloading redundant ISOs


  • [COOK-2174]: pxe_dust needs to not depend on the apache2's default site being enabled
  • node['pxe_dust']['default'] attributes may be used to override any data bag settings
  • use ['apt']['cacher_port'] from search results and gate on ['apt']['cacher-client']['restrict_environment']
  • Use of the local has been documented and the files moved into the doc_root which is now browseable.
  • Chef-Solo safe
  • Debian 7.1 support
  • Test-Kitchen coverage


  • custom machines (crushinator) don't clean up when changed
  • foodcritic cleanups


  • refactor the default recipe to include installers and bootstrap_template recipes
  • bootstrap_template recipe generates a local mirror bootstrap template that uses a local and local full stack installers
  • installers recipe broken out to download the Chef full stack installers and write out Chef bootstraps.
  • require platform in the pxe_dust data bag


  • switched to LVM for Ubuntu
  • Ruby syntax cleanup per
  • enforce pxe-booted NIC as eth0 via the pxelinux.cfg.erb, 'IPAPPEND 2' and a udev rule in the
  • added DEBCONF_DEBUG=5 for ridiculous amounts of debugging with preseed
  • foodcritic cleanups


  • added ability to set the environment for nodes
  • support OS installation off of network interface besides eth0


  • [COOK-1621]: support unmanaged preseed files (Craig Tracey)
  • support new Omnitruck downloads for the Omnibus installer


  • [COOK-1502]: pxe_dust has some if statements that could that could be reduced (Scott M. Likens)
  • Changing the addresses databag items to have the hostname as their value (Austin Page)
  • Updating default chef version (Austin Page)
  • support multiple items in the run list from the data bag
  • switch from eth0 to auto for pxelinux.cfg
  • take an optional list of packages to install


  • take default run_lists when none-specified
  • clean up installer when finished


  • added attribute for always pulling latest Chef installer


  • [COOK-1369]: Ubuntu 12.04 Precise Pangolin support


  • updated to use apt cookbook using apt-cacher-ng
  • make local mirrors of the netboots
  • added Debian support


  • [COOK-999]: uses the full stack intaller for bootstrapping nodes.


  • Fixes COOK-481, COOK-594

Foodcritic Metric

2.0.0 passed this metric