New Docs are available at

All new features, starting with 2.4.0, will be documented there.

Setting Up a Custom AWS ParallelCluster Cookbook


The following are instructions for use a custom version of the AWS ParallelCluster cookbook recipes. This is an advanced method of customizing AWS ParallelCluster, with many hard to debug pitfalls. The AWS ParallelCluster team highly recommends using Custom Bootstrap Actions scripts for customization, as post install hooks are generally easier to debug and more portable across releases of AWS ParallelCluster.


  1. Clone the cookbook and make changes

    $ git clone
    # Make changes to cookbook
  2. Upload the cookbook, changing [your_bucket] to a bucket you own

    $ cd aws-parallelcluster-cookbook
    $ /bin/bash util/ --bucket [your_bucket] --srcdir .
  3. From the output above, add the following variable to the AWS ParallelCluster config file, under the [cluster ...] section

    custom_chef_cookbook =