GitHub

Let your team sign in with their GitHub accounts.

Your callback URL

GitHub will ask for an authorization callback URL. Use your hub’s URL with this exact path:

https://your-hub-url/api/auth/github/callback

Setup

Create an OAuth app

Head to GitHub Developer Settings and click New OAuth App. Fill in the application name and homepage URL.

Set the callback URL

Set the Authorization callback URL to https://your-hub-url/api/auth/github/callback, then click Register application.

Grab your credentials

Copy the Client ID and generate a Client Secret.

Add them to Perch

Paste both into the GitHub card in Perch (Admin → Auth) and enable it.

Organization restriction

Want to limit sign-ins to members of a specific GitHub org? Fill in the Allowed Org field with the org’s slug (like my-company), and anyone outside that org gets turned away at login.

Leave it blank to allow any GitHub account.