Setup guide

Integration keys and secrets

This page summarizes the values required for local setup. The full runbook lives in docs/integration-keys.md.

Back home

Okta

  • Create a Web OIDC app integration in Okta.
  • Set the callback URL to http://localhost:3000/api/auth/callback/okta.
  • Set the sign-out redirect to http://localhost:3000.
  • Copy the client ID, client secret, and issuer URL into the environment file.

NextAuth

  • Set NEXTAUTH_URL to the app URL.
  • Generate NEXTAUTH_SECRET with openssl rand -base64 32.
  • Use a different secret for production.

PostgreSQL

  • Get the host, port, database name, username, and password from your provider.
  • Assemble DATABASE_URL in Prisma's postgresql://... format.
  • Run prisma generate and prisma migrate dev after filling .env.