Grunt Cloudfiles

Grunt task to work with Rackspace Cloudfiles
Alternatives To Grunt Cloudfiles
Project NameStarsDownloadsRepos Using ThisPackages Using ThisMost Recent CommitTotal ReleasesLatest ReleaseOpen IssuesLicenseLanguage
Asset Rack3305354 years ago30October 14, 201354CoffeeScript
Static Web Framework for Nodejs
4 months ago74apache-2.0Java
Application LIfecycle ENablement for Cloud
a year ago34mitHTML
A cloud based character sheet for the Pathfinder Roleplaying Game
Grunt Cloudfiles2911237 years ago8April 30, 20146mitJavaScript
Grunt task to work with Rackspace Cloudfiles
6 years ago2otherPython
Eucalyptus Management Console
Grunt Init Cep13
7 months ago1JavaScript
Create an empty Creative Cloud extension project ready to be used with grunt-cep.
Usc Isi I2.github.io13
7 days ago1apache-2.0HTML
Website for USC ISI information integration group
Gitana Javascript Driver11222 days ago3March 21, 20216apache-2.0JavaScript
Cloud CMS JavaScript Driver Library
Fuel Throttle Node10
6 years ago11JavaScript
Application scaffolding tool for creating Hub Exchange Apps
6 years agogpl-3.0JavaScript
Kolore is a Flask based CMS for Google App Engine
Alternatives To Grunt Cloudfiles
Select To Compare

Alternative Project Comparisons

Grunt Cloud Files

Call For Help

I wrote this to solve a particular problem we were facing on a project. I kept it up for a while, but I'm not suing the plugin anymore, and I no longer have the time to keep up with it.

If you are interested in helping, please reach out to me and we can talk through the code and things, and some 'next steps'. If all goes good I can add you to the Authors list on NPM for publish rights.


Cloud Files is Rackspace's cloud object storage. It's simliar to Amazon S3.

This task is based on grunt-s3 by Aaron Forsander, and uses the pkgcloud client by Nodejitsu.

This is all designed to work with Rackspace Cloud Files, and hasn't been tested on OpenStack Storage.


  1. npm install grunt-cloudfiles --save-dev (or manually add grunt-cloudfiles to your package.json).
  2. Add grunt.loadNpmTasks('grunt-cloudfiles'); to Gruntfile.js


Add the task to your Gruntfile's grunt.initConfig:

cloudfiles: {
  prod: {
    'user': 'your Rackspace username',
    'key': 'your Rackspace API key',
    'region': 'DFW',
    'upload': [{
      'container': 'name of your Cloud Files container',
      'src': 'source/static/**/*',
      'dest': 'some/folder/',
      'stripcomponents': 1,
      'purge': {
        'emails': ['[email protected]'],
        'files': ['index.html']

Stripcomponents (as in tar) will strip X leading path parts from the source dir. In the example above, the file source/static/js/app/main.js will be uploaded to some/folder/static/js/app/main.js, with the source/ part being removed.

Since this is a multi task, you can add multiple targets as needed. In this example we only have prod, but you could have staging, etc.

Remember that your Rackspace API key is private. If you are commiting your Gruntfile to a public repository, you probably want to store it in a separate local_config.json file.

For Rackspace UK users an additional configuration parameter authUrl is required to use the correct CDN url for UK accounts.

cloudfiles: {
  prod: {
    'region': 'LON',
    'authUrl': '',



  • added an option to purge files after the upload


  • added support for regions
  • added syncing based on MD5 Hash
  • added ability to create and/or set the CDN enabled container if neither exists
  • cleaned up code and moved from deferreds


  • Added support for Rackspace UK cloudfile accounts


  • Allow for destination folder in container


  • Migrated to pkgcloud cloud
  • Support grunt >= 0.4.0


  • Auth and adding files

Future Work

  • Provide full management of files
  • Implement meta tags


Popular Grunt Projects
Popular Cloud Computing Projects
Popular Build Tools Categories

Get A Weekly Email With Trending Projects For These Categories
No Spam. Unsubscribe easily at any time.
Cloud Computing
Grunt Task