This add-on is operated by CLOUDFORGED, LLC
Flexible AWS S3 file storage without the hassle.
Last updated 11 July 2018
Table of Contents
Cloudcube is an add-on that provides fast and easy uploading and privacy management for static files on Amazon S3 via an intuitive dashboard.
Provisioning the add-on
Cloudcube can be attached to a Heroku application via the CLI:
A list of all plans available can be found here.
$ heroku addons:create cloudcube:PLANNAME -a HEROKU_APPNAME
CLOUDCUBE_ACCESS_KEY_IDis the AWS Access key for accessing the underlying AWS bucket.
CLOUDCUBE_SECRET_ACCESS_KEYis the AWS Secret that, when paired with the Access Key, allows manipulation of your cube from your app code.
CLOUDCUBE_URLis the base URL root of a cube. All public files have a URL path that begins with this value. For example, if
https://cloudcube.url/mycube, then a public file within the cube (e.g.,
public/example.txt) is accessible from
Custom cube names
Some plans allow a custom name for your cube to be supplied via the Heroku CLI during provision. The command for doing so is:
$ heroku addons:create cloudcube:PLANNAME -a HEROKU_APPNAME --cubename=CUSTOMCUBENAME
If the custom cube name is not available, the provision attempt will return an error.
The Cloudcube dashboard is a GUI representation of your cube and its contents. You can use it to upload and search for files, as well as move, rename, and delete them.
You can also reveal your cube’s AWS IAM credentials and current storage usage from the side pane:
Cloudcube files can be either public or private. Public files are given a URL that can be shared with others or used from your application code. Private files are not given a URL and cannot be accessed. The privacy of a file is determined by its file path within the cube.
Making a file public or private
To make a file public, its path must include a directory named
public. All other files are private by default.
For example, the following file is public because its path includes a
The following file is private because its path does not contain a
A directory named
public anywhere in a file’s path will cause the file to be public. For example, the following file is public:
Connecting from within your Heroku app
Cloudcube provides AWS IAM credentials that you can use to access your cube programmatically.
Accessing from your language of choice
Migrating between plans
Your Cloudcube plan can be upgraded or downgraded from your Heroku application’s dashboard under Resources by choosing Edit Plan.
It can also be changed via the following CLI command:
$ heroku addons:upgrade cloudcube:NEW_PLANNAME -a HEROKU_APPNAME
Removing the add-on
Removing the add-on will result in the permanent loss of all files in your cube!
Cloudcube can be removed from your application via the Heroku Dashboard under ‘Resources’.
It can also be removed via the following CLI command:
$ heroku addons:destroy cloudcube -a HEROKU_APPNAME