Classic Docs
Docs Navigation

Connecting a Git Service Account

Currently, Semaphore supports adding repositories from GitHub and Bitbucket. To connect your Semaphore account to your GitHub or Bitbucket account, follow these steps:

  1. Click on your profile picture in the upper-right corner of the Semaphore homepage and select "Settings",
  2. Choose the "Git Services tab" and click on the appropriate button to connect your Semaphore account to your GitHub or Bitbucket account,

adding git services

3.Choose if you'd like to give Semaphore access to public projects only, or both private and public.

public private repos

Note: If you're connecting a Bitbucket account, this step is skipped because Bitbucket only supports giving access to both private and public repositories at the same time.

After you authorize Semaphore to access your account for the chosen Git service, you should see that Semaphore has a working connection.

working repo

You now have successfully connected your Semaphore account to GitHub. You can follow the same steps again to connect to Bitbucket.

Note: Semaphore account can only be associated with one GitHub account. This also applies to Bitbucket - Semaphore account cannot be associated with more than one Bitbucket account.

# Restoring an invalid Git Service Connection

To check if your Git service connection is valid, you can go to the Git Services tab. If you have an invalid connection, Semaphore will detect this, and offer you the options to either restore your connection, or remove it.

Note: In case you decide to change the username of your GitHub account associated with the Semaphore account, it is needed to reconnect your GitHub and Semaphore account because Semaphore won’t update it automatically. In this situation, please contact us at and we will provide you with the needed steps.

Semaphore Docs are open source — Edit on GitHub


Occasional lightweight product and blog updates. Unsubscribe at any time.

2009-2020 © Rendered Text. All rights reserved. Terms of Service, Privacy policy, Security.