Skip to main content

Documentation Index

Fetch the complete documentation index at: https://docs.replit.com/llms.txt

Use this file to discover all available pages before exploring further.

This guide walks you through creating a GitHub OAuth app in GitHub Developer Settings. You’ll collect a Client ID and Client Secret to plug into the Auth pane.
This page covers only the provider-side setup in GitHub Developer Settings. For the overall Clerk Auth flow — including enabling GitHub and entering credentials in the Auth pane — see Configuring OAuth credentials for an SSO provider in the Clerk Auth doc.

​
Prerequisites

  • A GitHub account
  • A published Replit app — custom OAuth credentials are only available in the Production environment
  • The GitHub provider’s edit panel opened in: Auth pane → Configure tab → SSO providers section → select the Production environment → select Edit next to GitHub

​
Step 1: Create a GitHub OAuth app

  1. Navigate to GitHub Developer Settings
  2. Select OAuth Apps in sidebar
  3. Select New OAuth App
  4. Fill in the application details:
Application name: Enter a name for your application. Homepage URL and Authorization callback URL: Set both to the exact values shown under Provider setup in the Auth pane. See Configuring OAuth credentials for an SSO provider for how to find them.
  1. Select Register application

​
Step 2: Generate client credentials

  1. You’ll see your Client ID on the app’s settings page - copy it
  2. Select Generate a new client secret
  3. Copy your Client Secret immediately
Save your Client Secret securely. You can’t view it again after leaving the page. If lost, you’ll need to generate a new one.

​
Troubleshooting

​
Redirect URI mismatch

  • Verify the Authorization callback URL exactly matches the value shown under Provider setup in the Auth pane
  • Check for typos or incorrect protocols
  • No trailing slashes

​
Invalid client

  • Double-check Client ID and Client Secret are copied correctly
  • Ensure no extra spaces when pasting

​
Not working on custom domain

  • Update the Homepage URL and Authorization callback URL to the custom-domain values shown under Provider setup in the Auth pane