Skip to Content

Recently my colleague Chris Whealy came up with an interesting problem. He had a static website that needed to be served from Cloud Foundry but he wanted a code free solution. Rather than using Node.JS and Express we felt there was probably an easier solution somewhere that could be applied to this case. From looking at the Cloud Foundry Buildpacks we found that the staticfile buildpack deploys an instance of Nginx to the server and then uploads your HTML and associated files to a folder that nginx can serve. Of course this solution is not for non static websites such as those running express which require server side code to execute to render code on the client, but for simple solution it is often overkill to do anything more than this.


Stark and Wayne came up with one or two good suggestions on how to use the staticfile buildpack but there was nothing around showing a very simple example.


To that end I decided to build one to see what it would do.


I created a subfolder called “src” and put my website into that along with an empty “staticfile.” file. This empty file holds any configurations you might need for the buildpack or for nginx, but we do not need any.

In the root folder we create the manifest.yml file that are the deployment instructions for Cloud Foundry.


The manifest.yml file is also very simple:

- name:      myStaticHtmlApp
  instances: 1
  memory: 256M
  disk_quota: 256M
  path:      src


We have a single application called myStaticHtmlApp that uses 256Mb ram and diskspace. You can probably get away with 64Mb however. The key however is the path property which defined where the source code is to upload to the nginx server. The will only upload the files in the path folder so if any temporary files are created then these should be outside the folder.


Login to Cloud Foundry and create a new space if you have not, making it the default space to upload app and content to. With that just do a “cf push” from the folder containing the manifest.yml file and this will create a new nginx server and deploy your source code.


Open your Cloud Foundry HANA Trial account and look at the default space and your app should be running there where you can open it.


Hopefully this has provided some insight into installing and running a codeless webserver on cloud foundry.

To report this post you need to login first.

1 Comment

You must be Logged on to comment or reply to a post.

  1. Wolfgang Röckelein

    Hi Paul,

    thank you for this helpful blog.

    Isn’t it also possible to use the Application-Router for serving static content, cf. ?




Leave a Reply