Skip to content

OAuth Configuration

Third-party authentication settings for Google, GitHub, and Apple.

Google OAuth

VariableDefaultSensitiveDescription
OAUTH_GOOGLE_ENABLEDfalseNoEnable Google OAuth.
OAUTH_GOOGLE_CLIENT_ID(empty)NoGoogle OAuth client ID.
OAUTH_GOOGLE_CLIENT_SECRET(empty)YesGoogle OAuth client secret.

GitHub OAuth

VariableDefaultSensitiveDescription
OAUTH_GITHUB_ENABLEDfalseNoEnable GitHub OAuth.
OAUTH_GITHUB_CLIENT_ID(empty)NoGitHub OAuth client ID.
OAUTH_GITHUB_CLIENT_SECRET(empty)YesGitHub OAuth client secret.

Apple OAuth

VariableDefaultSensitiveDescription
OAUTH_APPLE_ENABLEDfalseNoEnable Apple OAuth.
OAUTH_APPLE_CLIENT_ID(empty)NoApple OAuth client ID (Service ID).
OAUTH_APPLE_CLIENT_SECRET(empty)YesApple OAuth client secret.
OAUTH_APPLE_TEAM_ID(empty)NoApple Team ID.
OAUTH_APPLE_KEY_ID(empty)NoApple Key ID.

Setup Guides

Google OAuth

  1. Go to Google Cloud Console
  2. Create a new project or select existing one
  3. Navigate to APIs & Services > Credentials
  4. Create an OAuth 2.0 Client ID (Web application)
  5. Add your redirect URI: https://your-domain.com/api/auth/oauth/google/callback

GitHub OAuth

  1. Go to GitHub Developer Settings
  2. Click New OAuth App
  3. Set Authorization callback URL to: https://your-domain.com/api/auth/oauth/github/callback

Apple OAuth

  1. Go to Apple Developer
  2. Register a Services ID in Certificates, Identifiers & Profiles
  3. Configure Sign in with Apple for your domain

Example

bash
# Google
OAUTH_GOOGLE_ENABLED=true
OAUTH_GOOGLE_CLIENT_ID=your-google-client-id.apps.googleusercontent.com
OAUTH_GOOGLE_CLIENT_SECRET=GOCSPX-your-secret

# GitHub
OAUTH_GITHUB_ENABLED=true
OAUTH_GITHUB_CLIENT_ID=Ov23lixxxxxxxxx
OAUTH_GITHUB_CLIENT_SECRET=xxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxx