| title | description |
|---|---|
Add GitHub as a social connection |
Learn how to allow users to sign up and sign in to your Clerk app with their GitHub account using OAuth. |
<TutorialHero beforeYouStart={[ { title: "A Clerk app is required.", link: "/docs/quickstarts/setup-clerk", icon: "clerk", }, { title: "A GitHub account is required.", link: "https://github.com/signup", icon: "user-circle", }, ]} />
Enabling OAuth with GitHub allows your users to sign up and sign in to your Clerk app with their GitHub account.
For development instances, Clerk uses preconfigured shared OAuth credentials and redirect URIs—no other configuration is needed.
- In the Clerk Dashboard, navigate to the SSO connections page.
- Select Add connection and select For all users.
- In the Choose provider dropdown, select GitHub.
- Select Add connection.
For production instances, you must provide custom credentials.
To make the setup process easier, it's recommended to keep two browser tabs open: one for the Clerk Dashboard and one for GitHub's Developer Settings.
### Enable GitHub as a social connection in Clerk- In the Clerk Dashboard, navigate to the SSO connections page.
- Select Add connection and choose For all users.
- In the Choose provider dropdown, select GitHub.
- Ensure that both Enable for sign-up and sign-in and Use custom credentials are toggled on.
- Save the Authorization Callback URL somewhere secure. Keep the modal and page open.
- In the left sidenav of your GitHub's Developer Settings, select OAuth Apps.
- Select New OAuth app. You'll be redirected to the Register a new OAuth app page.
- Complete the required fields. In Authorization Callback URL, paste the Authorization Callback URL you saved from the Clerk Dashboard.
- Select Register application. You'll be redirected to your app's General page.
- Select Generate a new client secret. Save the Client ID and Client Secret somewhere secure.