Use from Heroku

Provisioning the add-on

CloudMQTT can be attached to a Heroku application via the CLI:

$ heroku addons:add cloudmqtt
'-----> Adding cloudmqtt to sharp-mountain-4005... done, v18 (free)'

Once CloudMQTT has been added a CLOUDMQTT_URL setting will be available in the app configuration and will contain the canonical URL used to access the newly provisioned CloudMQTT service instance. This can be confirmed using the heroku config:get command.

$ heroku config:get CLOUDMQTT_URL
mqtt://user:pass@broker.cloudmqtt.com

After installing CloudMQTT the application should be configured to fully integrate with the add-on.

Dashboard

The CloudMQTT dashboard allows you to monitor your current connection and message traffic statistics.

The dashboard can be accessed via the CLI:

$ heroku addons:open cloudmqtt
'Opening cloudmqtt for sharp-mountain-4005...'

or by visiting the Heroku apps web interface and selecting the application in question. Select CloudMQTT from the Add-ons menu.

Migrating between plans

All plan migrations are completely transparent and instantaneous.

Use the heroku addons:upgrade command to migrate to a new plan.

$ heroku addons:upgrade cloudmqtt:newplan
'-----> Upgrading cloudmqtt:newplan to sharp-mountain-4005... done, v18 ($49/mo)'
'Your plan has been updated to: cloudmqtt:newplan'

Removing the add-on

CloudMQTT can be removed via the CLI.

This will destroy all associated data and cannot be undone!

$ heroku addons:remove cloudmqtt
'-----> Removing cloudmqtt from sharp-mountain-4005... done, v20 (free)'

Overview