Set up GitHub or Google sign-in

For a self-hosted instance, configure GitHub, Google, or email sign-in. Cloud users do not need to create provider credentials.

The examples use https://comments.example.com as the Quipthread address. Replace it with your BASE_URL.

GitHub

1. Create a GitHub OAuth App

1. Go to github.com/settings/developers and click New OAuth App.
2. Fill in the form:
   • Application name: anything (e.g. “Quipthread Comments”)
   • Homepage URL: your Quipthread address
   • Authorization callback URL: https://comments.example.com/auth/github/callback
3. Click Register application.
4. Copy the Client ID and generate a Client Secret.

2. Set environment variables

GITHUB_CLIENT_ID=your-client-id
GITHUB_CLIENT_SECRET=your-client-secret

Google

1. Create a Google OAuth Client

1. Open the Google Cloud Console and select or create a project.
2. Go to APIs & Services → Credentials and click Create Credentials → OAuth client ID.
3. Choose Web application as the application type.
4. Under Authorized redirect URIs, add: https://comments.example.com/auth/google/callback
5. Click Create and copy the Client ID and Client Secret.

Note

You may need to configure the OAuth consent screen before creating credentials. Set the user type to External and add your domain to the authorized domains list.

2. Set environment variables

GOOGLE_CLIENT_ID=your-client-id
GOOGLE_CLIENT_SECRET=your-client-secret

Callback URL format

Both providers follow the same pattern:

Provider	Callback URL
GitHub	https://comments.example.com/auth/github/callback
Google	https://comments.example.com/auth/google/callback

Build the callback from your exact BASE_URL, including its scheme and port, then append the provider path above.