New Docs are available at

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

Setting Up a Custom AWS ParallelCluster Node Package


The following are instructions for use a custom version of the AWS ParallelCluster Node package. 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. Identify the AWS ParallelCluster Node working directory where you have cloned the AWS ParallelCluster Node code

    _nodeDir=<path to node package>
  2. Detect the current version of the AWS ParallelCluster Node

    _version=$(grep "version = \"" ${_nodeDir}/ |awk '{print $3}' | tr -d \")
  3. Create an archive of the AWS ParallelCluster Node

    cd "${_nodeDir}"
    _stashName=$(git stash create)
    git archive --format tar --prefix="aws-parallelcluster-node-${_version}/" "${_stashName:-HEAD}" | gzip > "aws-parallelcluster-node-${_version}.tgz"
  4. Create an S3 bucket and upload the archive into the bucket, giving public readable permission through a public-read ACL

    _bucket=<the bucket name>
    aws s3 cp --acl public-read aws-parallelcluster-node-${_version}.tgz s3://${_bucket}/node/aws-parallelcluster-node-${_version}.tgz
  5. Add the following variable to the AWS ParallelCluster config file, under the [cluster …] section”

    extra_json = { "cluster" : { "custom_node_package" : "https://s3.<the bucket region>${_bucket}/node/aws-parallelcluster-node-${_version}.tgz" } }