Environment Variables

Copy .env.example to .env and fill in the values below.

Required

• DATABASE_URL — PostgreSQL connection string
• AUTH_SECRET — Random secret for NextAuth. Run: openssl rand -base64 32
• NEXTAUTH_URL — Public URL of the app (e.g. http://localhost:3000)

Optional — AI Search

• OPENAI_API_KEY — Required for generating article embeddings
• QDRANT_URL — Qdrant vector DB URL (default: http://localhost:6333)
• QDRANT_API_KEY — Only needed if Qdrant has authentication enabled

Optional — OAuth

• GITHUB_CLIENT_ID — GitHub OAuth app client ID
• GITHUB_CLIENT_SECRET — GitHub OAuth app client secret

Optional — Storage

Image uploads require S3-compatible storage.

• S3_BUCKET — S3 bucket name
• S3_REGION — e.g. us-east-1
• S3_ACCESS_KEY — AWS access key ID
• S3_SECRET_KEY — AWS secret access key