Integrating with GitHub / GitHub Enterprise allows you to use it as a Git hosting provider and sign in to the workspace with your GitHub profile.

Register GitHub OAuth app

  1. Log in to your Buddy instance as admin.
  2. Add a new project and select GitHub as the provider.
  3. A screen will appear with details on how the integration works. Click Configure GitHub app to proceed:

  1. Copy the Authorization Callback URL line. You will need it to register the OAuth application in your GitHub account.

  1. Log in to your account on GitHub.
  2. Go to Developer settings → OAuth Apps and add a new OAuth application with the following settings:

  3. Application nameBuddy
  4. Homepage URL → the public URL of your Buddy instance
  5. Authorization callback URL

    → the callback URL that you copied in step #3

  6. Click Register application to finish configuration.

  1. Generate a new Client secret and paste it in the corresponding input in Buddy together with the Client ID:

  1. Restart Buddy to apply changes.
  2. You will now be able to use the newly configured app to authorize in your GitHub account: