This add-on is operated by Rendered Text

Continuous integration and deployment for web apps.


Last Updated: 07 May 2015

Table of Contents

Semaphore add-on is an add-on for providing Semaphore service to all Heroku users.

Semaphore is a hosted continuous integration service for Ruby, JavaScript and Clojure applications.

This document provides all the information you need in order to use Semaphore with your application hosted on Heroku.

Activating the add-on

Semaphore add-on can be attached to a Heroku application in two ways:

A list of all plans available can be found here.

  • via Heroku web interface at the add-on catalog

  • via Heroku command-line interface with command heroku addons:create

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

Using Semaphore

After enabling the add-on for the first time, you need to go through the following steps:

  • Open Semaphore
  • Connect with GitHub
  • Select project
  • Review build settings
  • Invite your collaborators from GitHub
  • Build

Open Semaphore

You can reach Semaphore via your Heroku application’s resources page or via heroku addons:open semaphore.

Connect with GitHub

Choose whether you’d like to build from a private or public repository on GitHub.

GitHub authentication screen

Now you can authorize Semaphore to access your GitHub account.

Authorize GitHub account

Select project

Select the project and the first branch that you want to build.

Select project

Review build commands

Semaphore will analyze your project and present you a suggested configuration and build commands that will run every time you push to the selected repository. If necessary you can change the version of your language runtime or build commands at this step.

Build settings

Invite your collaborators from GitHub

If your project has collaborators on GitHub, you can invite them at this step. Enter their emails and invitations will be sent. After they have signed up, the project will be available on their dashboards.

Invite your collaborators from GitHub

You can also skip this step and start your first build.

Run Your First Build

At this point, setup is complete and your build will begin. You can watch its' progress live or come back and view the logs later. Semaphore will automatically test your application every time you push to GitHub. New branches will be detected and built automatically.

Build status

After the build is finished, you will receive an email about its result. You can change or set up new notifications in your project settings, Notifications tab.

From now on you can also watch the build status of your project on the Semaphore dashboard.

Migrating between plans

Migrating between plans can be done:

  • via Heroku interface at add-on catalog

  • via Heroku command-line interface with command heroku addons:upgrade

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

Removing the add-on

This will destroy all associated data and cannot be undone!

Semaphore add-on can be removed:

  • via Heroku interface at add-on catalog

  • via Heroku command-line interface with command heroku addons:destroy

    $ heroku addons:destroy semaphore
    -----> Removing semaphore from sharp-mountain-4005... done, v20 (free)

Supported application stack

Semaphore can test Ruby, JavaScript and Clojure projects. To find out more about supported application stack please visit Semaphore documentation.


Semaphore support and runtime issues should be logged with Heroku Support at Heroku Support channels. Any non-support related issues or product feedback is welcome at or via Twitter @semaphoreapp

For more information about Semaphore visit and Semaphore documentation site.