Knowledge

How to integrate Buddy Enterprise with GitHub

Integrating with GitHub will allow you to use it as a Git hosting provider and log in to the workspace with your GitHub profile.

Register GitHub OAuth app

  1. Log in to your Buddy Enterprise workspace as admin and add a new project.
  2. Select GitHub as the provider.
  3. Click Configure Cloud and copy the Callback URL line.

    Configuring Github integration #1
    Configuring Github integration #1
  4. Go to https://github.com/settings/developers and click Register a new application.
  5. Fill in the application details:

    • Application name → anything, eg. Buddy Enterprise
    • Homepage URL → anything, eg. https://buddy.works
    • Authorization callback URL → paste the callback URL that you've copied from Buddy Enterprise

    Click Register a new application to save changes.

  6. Copy Client ID and Client Secret

Configure GitHub app in Buddy

  1. Log back to your Buddy Enterprise workspace as admin.
  2. Go to the workspace Preferences and switch to the Applications tab.
  3. Click Configure under the GitHub logo and paste the ID and Secret.
  4. Set up the Webhook address. The webhook is an URL to which GitHub will send information on changes in the repositories. The address must be available from the outside: if your installation is assigned to an internal IP (eg. 192.168.x.x), make sure to paste your external IP to that field and redirect the oncoming traffic on your router to the address of your Buddy Enterprise instance.
  5. Click Save changes and restart the machine to apply the new settings.

    Configuring Github integration #2
    Configuring Github integration #2

Get started now

14 days of unlimited trial. No credit card required.