Environment variables
For self-hosting or running the repo locally. If you only use Linktrap in the browser, you do not set these.
End users can ignore this page. Operators: copy from .env.example and set values per environment. New here? See Getting started.
Required for core product
| Variable | Purpose |
|---|---|
TURSO_DATABASE_URL | libSQL URL (libsql://… or file:./local.db). |
TURSO_AUTH_TOKEN | Token for remote Turso (omit for file DB). |
NEXT_PUBLIC_CLERK_PUBLISHABLE_KEY | Clerk publishable key (browser). |
CLERK_SECRET_KEY | Clerk server secret. |
NEXT_PUBLIC_APP_URL | Canonical origin (short links, Stripe return URLs, metadata base). |
Optional — AI wizard
OPENAI_API_KEY—/api/generate-meta.BLOB_READ_WRITE_TOKEN— Vercel Blob for generated images.
Optional — Stripe (Pro)
STRIPE_SECRET_KEYSTRIPE_WEBHOOK_SECRET— signing secret for/api/stripe/webhook.STRIPE_PRICE_ID_PRO— recurring price id for Checkout.
Security
Never commit real secrets. Use platform secret stores (Vercel Environment Variables, etc.).