> For the complete documentation index, see [llms.txt](https://docs.shipwithdjango.com/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://docs.shipwithdjango.com/authentication/github.md).

# GitHub

To allow users to sign up and log in using their GitHub accounts, set `ALLOW_GITHUB_LOGIN` to `True`. Additionally, you will need to configure your GitHub application by registering it with GitHub:

1. Visit [GitHub Applications](https://github.com/settings/applications/new) while logged into your GitHub account.
2. Fill in the required details. Make sure the **Authorization callback URL** is set to `https://YOUR_DOMAIN_HERE.COM/swd/accounts/github/login/callback/`.
3. Once your application is created, GitHub will provide you with a **Client ID** and **Client Secret**.
4. Update the `GITHUB_CLIENT_ID` and `GITHUB_CLIENT_SECRET` in your `CONFIG/authentication.py` config file with these values.
