Configuring the GitHub Client

Published on February 23rd, 2021

Table of Contents


In order to enable user driven front end operations against GitHub APIs (e.g. viewing a file inline in the backstage UI) Backstage will need to be configured with a client id and client secret.

These are set within backstage at the following url:


This page describes how to get the client id and secret.


  1. Start by visiting the organization application settings page for your github organization<github organization name>/settings/applications

  2. Click on the “New OAuth App” button.

  3. If your tenant name was “acme” you would enter the following settings as follows:

    GitHub oauth app configuration

  4. Click Generate a new secret

  5. Copy the client id and client secret

  6. Visit https://<tenant-name> and enter these values into GITHUB_CLIENT_ID and GITHUB_CLIENT_SECRET.