Environment Variables

Required Variables

Variable Description Required

TURSO_DATABASE_URL

Turso database connection URL

Yes

TURSO_AUTH_TOKEN

Turso authentication token

Yes

OAuth Providers

Configure at least one OAuth provider for user authentication.

GitHub

Variable Description

GITHUB_CLIENT_ID

OAuth App client ID

GITHUB_CLIENT_SECRET

OAuth App client secret
Setup Steps

  1. Go to https://github.com/settings/developers

  2. Click "New OAuth App"

  3. Set callback URL: https://your-domain/api/auth/callback/github

  4. Copy Client ID and Secret

GitLab

Variable Description

GITLAB_CLIENT_ID

Application ID

GITLAB_CLIENT_SECRET

Application secret
Setup Steps

  1. Go to https://gitlab.com/-/user_settings/applications

  2. Create new application

  3. Scopes: read_user

  4. Callback URL: https://your-domain/api/auth/callback/gitlab

Google

Variable Description

GOOGLE_CLIENT_ID

OAuth 2.0 Client ID

GOOGLE_CLIENT_SECRET

OAuth 2.0 Client secret
Setup Steps

  1. Go to https://console.cloud.google.com/apis/credentials

  2. Create OAuth 2.0 Client ID

  3. Application type: Web application

  4. Authorized redirect URI: https://your-domain/api/auth/callback/google

Example .env File

# Database (required)
TURSO_DATABASE_URL=libsql://antora-themes-user.aws-us-east-1.turso.io
TURSO_AUTH_TOKEN=eyJhbGciOiJFZERTQSIsInR5cCI6IkpXVCJ9...

# GitHub OAuth (recommended)
GITHUB_CLIENT_ID=Iv1.abc123
GITHUB_CLIENT_SECRET=secret123

# GitLab OAuth (optional)
GITLAB_CLIENT_ID=app-id
GITLAB_CLIENT_SECRET=secret

# Google OAuth (optional)
GOOGLE_CLIENT_ID=123456.apps.googleusercontent.com
GOOGLE_CLIENT_SECRET=GOCSPX-secret

Vercel Configuration

Add all variables in:

  1. Project Settings → Environment Variables

  2. Or via CLI: vercel env add VARIABLE_NAME

Don’t commit .env to version control. It’s already in .gitignore.