GitHub

This guide explains how to set up GitHub as an authentication provider with Stack Auth. GitHub OAuth allows users to sign in to your application using their GitHub account.

For Development purposes, Stack Auth uses shared keys for this provider. Shared keys are automatically created by Stack, but show Stack's logo on the OAuth sign-in page. You should replace these before you go into production.

Integration Steps

Create a GitHub OAuth App

  1. Navigate to your GitHub Developer Settings.
  2. Click the New OAuth App button.
  3. Enter a name for your application, homepage URL, and a description.
  4. For Authorization callback URL, add https://api.stack-auth.com/api/v1/auth/oauth/callback/github
  5. Click Register application
  6. Save the Client ID and click Generate a new client secret to create your Client Secret.

Enable GitHub OAuth in Stack Auth

  1. On the Stack Auth dashboard, select Auth Methods in the left sidebar.
  2. Click Add SSO Providers and select GitHub as the provider.
  3. Set the Client ID and Client Secret you obtained from GitHub earlier.

Need More Help?

Stack Auth AI

Documentation assistant

Experimental: AI responses may not always be accurate—please verify important details.

For the most accurate information, please join our Discord or email us.

How can I help?

Ask me about Stack Auth while you browse the docs.