# GitHub

Use these instructions to set up GitHub as your SSO provider for Tonic Textual.

## **Create an OAuth application** <a href="#sso-github-oauth-app" id="sso-github-oauth-app"></a>

1. In GitHub, navigate to **Settings -> Developer Settings -> OAuth Apps**, then create a new application.
2. For **Application Name**, enter **Textual**.
3. For **Homepage URL**, enter `https://textual.tonic.ai`.
4. For **Authorization callback URL**, enter `https://your-textual-url/sso/callback/github`.

Replace `your-textual-url` with the URL of your Textual instance.

## **Create a client secret** <a href="#sso-github-client-secret" id="sso-github-client-secret"></a>

After you create the application, to create a new secret, click **Generate a new client secret**.

You use the client ID and the client secret in the Textual configuration.

## **Textual configuration** <a href="#sso-github-textual-config" id="sso-github-textual-config"></a>

After you complete the configuration in GitHub, you uncomment and configure the required [environment variables](https://docs.tonic.ai/textual/textual-install-administer/configuring-textual/textual-env-var-configure) in Textual.

For Kubernetes, in **values.yaml**:

```
# Github SSO Config
# -----------------
#githubClientId: <client-id>
#githubClientSecret: <client-secret>
```

For Docker, in **.env**:

```
#SOLAR_SSO_GITHUB_CLIENT_ID=#<client ID>
#SOLAR_SSO_GITHUB_CLIENT_SECRET=#<client secret>
```