Deploy static HTML/JS/CSS apps to Cloud Foundry
HTML JavaScript Ruby Shell Nginx
Latest commit 206728f Feb 24, 2017 @sesmith177 sesmith177 committed with athornton2012 Bump version to 1.3.18 [#140504923]
Signed-off-by: Anna Thornton <>

Cloud Foundry Static Buildpack

CF Slack Join us on Slack

A Cloud Foundry buildpack for static content such as websites (HTML/JS/CSS).

Buildpack User Documentation

Official buildpack documentation can be found at

Building the Buildpack

  1. Make sure you have fetched submodules

    git submodule update --init
  2. Get latest buildpack dependencies

    BUNDLE_GEMFILE=cf.Gemfile bundle
  3. Build the buildpack

    BUNDLE_GEMFILE=cf.Gemfile bundle exec buildpack-packager [ --cached | --uncached ]
  4. Use in Cloud Foundry

    Upload the buildpack to your Cloud Foundry and optionally specify it by name

    cf create-buildpack custom_node_buildpack 1
    cf push my_app -b custom_node_buildpack


Buildpacks use the Machete framework for running integration tests.

To test a buildpack, run the following command from the buildpack's directory:

BUNDLE_GEMFILE=cf.Gemfile bundle exec buildpack-build

More options can be found on Machete's Github page.


Find our guidelines here.

Help and Support

Join the #buildpacks channel in our Slack community if you need any further assistance.

Reporting Issues

Open a GitHub issue on this project here

Active Development

The project backlog is on Pivotal Tracker


This buildpack is based heavily upon Jordon Bedwell's Heroku buildpack and the modifications by David Laing for Cloud Foundry nginx-buildpack. It has been tuned for usability (configurable with Staticfile) and to be included as a default buildpack (detects Staticfile rather than the presence of an index.html). Thanks for the buildpack Jordon!