> ## Documentation Index
> Fetch the complete documentation index at: https://developers.plane.so/llms.txt
> Use this file to discover all available pages before exploring further.

# Github OAuth

Plane also supports GitHub OAuth so your users can sign-in with GitHub instead.

## Configure Plane as an OAuth app on GitHub

1. Log in to your [GitHub account](https://github.com/).
2. Click your profile's avatar and navigate to **Settings.**
3. Click **Developer Settings** and then **OAuth Apps**.
   <Frame>
     <img src="https://mintcdn.com/planesoftwareinc/bRLzJYKRFkf2RaPq/images/authentication/github/github-auth-1.png?fit=max&auto=format&n=bRLzJYKRFkf2RaPq&q=85&s=accafb7a0250a11600e3a4c515c524db" alt="" width="1920" height="1261" data-path="images/authentication/github/github-auth-1.png" />
   </Frame>
4. Click **Register a new application**.
5. Configure the following OAuth credentials for your Plane app.
   1. **Homepage URL**\
      The domain, with HTTPS, on which you host Plane, e.g., `https://app.plane.so`
   2. **Authorization Callback URL**\
      Append the path that users should be redirected to after they have authenticated with GitHub. e.g., `https://<plane.example.com>//auth/github/callback/` and `https://<plane.example.com>/auth/mobile/github/callback/` where `<plane.example.com>` is your self-hosted instance's domain.
6. Click `Register application` to save it.
   <Frame>
     <img src="https://mintcdn.com/planesoftwareinc/bRLzJYKRFkf2RaPq/images/authentication/github/github-auth-2.png?fit=max&auto=format&n=bRLzJYKRFkf2RaPq&q=85&s=adb935f81d5a90f16680724f1f25eca0" alt="" width="1920" height="492" data-path="images/authentication/github/github-auth-2.png" />
   </Frame>
7. Find the app you just registered and click through to find the client ID and the client secret. You will need this for the next steps.

## Configure Plane

<Frame>
  <img src="https://mintcdn.com/planesoftwareinc/0KaIKJNVgKAyWkhv/images/custom-sso/github-oauth.png?fit=max&auto=format&n=0KaIKJNVgKAyWkhv&q=85&s=4bffbdc7c155f4a299577c9ebad4e313" alt="GitHub Oauth Configuration" width="4599" height="1298" data-path="images/custom-sso/github-oauth.png" />
</Frame>

1. Go to `GitHub` on the Authentication screen of `/god mode`.
2. Add the client ID + the client secret from the GitHub app you just registered.
3. Click `Save `.

Your Plane instance should now work with GitHub sign-in.