Table of contents

Semaphore documentation

Welcome to the help and documentation site of Semaphore. There's a good chance your question might be answered here. If not, please email us. This website is open source - issues and pull requests are welcome.

Getting started

• Adding your GitHub project to Semaphore ^todo
• Running tests in parallel ^todo

The Semaphore platform

• The Ruby build sequence
• The deployment sequence ^todo
• Supported stack
• Platform changelog
• Available environment variables
• Caching between builds

Customizing your build

• Customizing build commands
• Using post-thread commands
• Exporting environment variables
• Adding custom configuration files
• Changing a system configuration file
• Adding more SSH keys
• Manually creating the database (new content merged with current 'how do I configure the db')
• Executing Postgres commands
• Running a build command on specific branch
• Switching Ruby version on specific branch
• How to skip building some commits

Managing dependencies

• Installing a system dependency
• Building a project with private gems
• Building a project with git submodules
• Installing additional version of Ruby
• Using wkhtmltopodf
• Using multiple databases ^todo

Build troubleshooting

• Fail: "Unknown database ‘xyz_test’" or "FATAL database 'xyx_test' does not exist"
• Fail: "fatal Could not parse object" during bundle install
• Fail: "file not found db:create (ArgumentError)"
• Fail: Permission denied from GitHub on bundle install
• Fail: Sphinx tests
• Tests or setup fail with "Real HTTP connections are disabled."
• Selenium tests are unable to obtain connection to Firefox
• Pending Cucumber scenarios
• Tests fail on Semaphore but pass locally
• Failed build reported as passed
• Issues with capybara-webkit
• Building projects that take longer than 60 minutes

Deploying your application

• Deploying with Capistrano
• Deploying to Heroku
• Deploying via Cloud 66
• Deploying with git-deploy
• Manually triggerring an automatic deploy
• Fail: "permission denied (publickey)"

Collaboration

• Adding and removing collaborators from project

Notifications

• Post-build webhooks
• Post-deploy webhooks
• Finding HipChat token

API

• Projects
• Branches & builds
• Servers & deploys

Integrations

• Code Climate
• CruiseControl status
• Third-party tools

Billing

• How to change credit card information
• Transferring project ownership
• Changing the project after repository or organization rename