New to Semaphore? Here’s how to get started

This time we’d like to surprise our community, especially the new Semaphore users. If you are considering trying out Semaphore, this simple guide will help you understand the basics of Semaphore and how to get up and running by following these steps :blush:.

This guide is based on our experience with onboarding teams, now long-time Semaphore customers, such as Confluent, Dribbble, Tigera, and many others.

Adding your first project

Adding your first project to Semaphore is pretty simple and can be done in two ways:

  1. Fork and run

With fork and run, you can try one of the example projects we have prepared for you. You will be able to Semaphore in action and reach your first green build in a jiff:

  1. Add your own project

You can try your own projects in Semaphore, which can be done in a few simple steps through the web interface or from the command line.

Useful Links:

Reaching your first green build

If your build on Semaphore is still red, you are just one tiny step away from making it green :blush: especially if you continue reading this section.

First, we recommend comparing the local dev stack with the one on Semaphore. Use sem-service and sem-version to ensure the proper versions of languages and services are in place.

Second, if you’re still having problems, launch a debugging session via SSH. This will provide direct access to the virtual machines Semaphore uses for running jobs. An SSH session can help you to quickly test solutions while getting familiar with the build environment.

In addition, our FAQ troubleshooting tips should come in handy when trying to get your builds to a green state:

Project settings

You can access your Project Settings by entering the desired project and clicking on Settings.

This is where you can set up your Secrets, Slack Notifications, Badges to display your projects’ current build status and more.

One of the settings that particularly sparks interest of new users is the Workflow Triggers functionality. It is available in the Project Settings => General => What to build? And it allows you to choose which GitHub events should trigger new workflows for your Semaphore project:

Adding People to an Organization

To let other people view your pipelines and delegate project management, open the menu and go to People. This will show the members in your organization and set permissions.

Semaphore Features

Semaphore rich features accelerate developer velocity. It supports any language & any platform, making the CI/CD process in your team smooth:

The list of most useful features was built based on new users’ interests. For more information on working with Semaphore and its capabilities, check out the official Semaphore Documentation.

Here is also the Semaphore Roadmap from which you can learn more about the upcoming features. If you have a suggestion or an idea of a feature that would help Semaphore meet your needs, please submit a New Idea.

Extending your trial for another 14 days

If your 14-day trial is about to expire and you need a few more weeks to get up and running, just send us a quick email at from the same address you’ve used to sign up and let us know what delighted you the most about Semaphore :blush:. We’ll extend your trial and our team will be happy to answer any additional questions you might have about Semaphore.

Happy Building!