Tddium by Solano Labs

This add-on is operated by Solano Labs

Continuous Integration and Deployment in the cloud.

Tddium by Solano Labs

Last Updated: 26 August 2014

addons test

Table of Contents

Tddium is an add-on for providing parallel testing, continuous integration (CI) and deployment for your Heroku App.

Tddium’s distributed build and test platform watches your shared source repositories for code changes, automatically configures databases and services for your app, safely runs your tests in parallel for a huge speedup, gives you realtime feedback and sends you convenient notifications via email, Campfire, and Hipchat. You can also use Tddium’s CLI to take advantage of our parallelism even before you push to a shared repository.

Tddium is accessible via our webapp and our CLI, works with Ruby, JRuby, Python, Java and PHP apps, and has a supported client library in Ruby.

Provisioning the add-on

Tddium can be attached to a Heroku application via the Heroku Dashboard or the CLI:

A list of all plans available can be found here.

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

Once Tddium has been added TDDIUM_USER_NAME and TDDIUM_API_KEY settings will be available in the app configuration and will contain credentials to access the Tddium service. These settings will automatically be used by the tddium command to connect your account. This can be confirmed using the heroku config:get command.

$ heroku config:get TDDIUM_API_KEY

After installing Tddium, visit the Tddium control panel to configure repos and branches to build and deploy. You can reach the Tddium control panel by clicking on the Tddium icon in your app’s Heroku dashboard. You’ll be automatically signed in to Tddium via Heroku’s Single-Sign-On functionality.

Local setup

No explicit local setup is necessary. However, many Tddium users appreciate using the tddium gem to start builds from the CLI and have quick access to test results and account information, without leaving the terminal.

Environment setup

Install the tddium gem and log in using the authentication token and instructions described in your Tddium user settings page.

$ gem install tddium
$ tddium login <token>
Please upload a public key to authenticate your local pushes to Tddium.
Public key [~/.ssh/]:

Running tests and builds with Tddium

From your Tddium dashboard, you can configure Continuous Integration for repos and branches to build automatically via commit hooks, and you can connect your Github account for a full end-to-end solution supporting Pull Requests and Github Status integration.

To start tests from the CLI, use the tddium run command. It will automatically configure your repository and identify your tests. It will then start a test run.

$ tddium run

To set up Continuous integration, use the tddium suite command

$ tddium suite

If you have any trouble getting started, read through our getting started guide.

Supported Languages

Tddium has first-class support for Ruby, JRuby, and Python apps.

Java and PHP are available to select users in private-beta. If you have a Java or PHP Heroku app, and you’d like to participate, send us a note.


To see the updated list of all of the databases, search engines, and infrastructure backends we support for running your tests, take a look at our compatibility list.