Guides

Self-hosting

Railway/Postgres plus Vercel deployment, environment variables, security checks, and rollback.

Documented primary shape is Railway API + managed Postgres and Vercel dashboard. Fly.io is backend fallback. Current release marks deployment configs as stub: production DNS/TLS deployment is not verified.

#Services

text

intentlayer.dev      → Vercel landing, docs, dashboard
api.intentlayer.dev  → Railway FastAPI
managed Postgres     → tenant data

Backend startup runs Alembic and idempotent seed before Uvicorn.

#Required production checks

Writable production must set ENVIRONMENT=production, DEMO_MODE=false, AUTH_REQUIRED=true, strong SECRET_KEY, and nonempty exact ALLOWED_ORIGINS. LLM scorer also requires LLM_API_KEY.

#Secrets and configuration

Variable	Secret	Purpose
`DATABASE_URL`	yes	Managed Postgres connection.
`SECRET_KEY`	yes	API-key hashing and signed dashboard sessions; 32+ chars.
`LLM_API_KEY`	yes	Required only for `SCORER_MODE=llm`.
`ENVIRONMENT`	no	Set `production` for production validation.
`DEMO_MODE`	no	Read-only hosted demo switch.
`AUTH_REQUIRED`	no	Required true for writable production.
`ALLOWED_ORIGINS`	no	Exact comma-separated browser origins.
`REDACTION`	no	`standard`, `strict`, or `off`.
`SCORER_MODE`	no	`heuristic` or `llm`.
`LLM_BASE_URL`	no	OpenAI-compatible API base.
`LLM_MODEL`	no	Scorer model ID.
`AMBIGUITY_THRESHOLD`	no	Default `0.55`.
`FAILURE_COST`	no	Default `12`.
`NEXT_PUBLIC_API_URL`	no	Browser-facing backend origin.
`BACKEND_INTERNAL_URL`	no	Dashboard proxy backend origin.
`NEXT_PUBLIC_DEMO_MODE`	no	Dashboard route behavior.
`DASHBOARD_AUTH_REQUIRED`	no	Private dashboard auth gate.

#Verify

bash

curl https://api.intentlayer.dev/health
curl -I https://intentlayer.dev
curl -I https://intentlayer.dev/docs

Hosted demo expects playground 200 and gate 403. Writable production expects bearer-authenticated gate.

#Rollback

Promote prior healthy Vercel deployment; redeploy prior Railway deployment; or deploy prior Fly image. Alembic migrations are described as additive.

Source truthDEPLOY.mdfly.tomlrailway.tomldashboard/vercel.json