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. Production uses liquet.tech for dashboard traffic and api.liquet.tech for API traffic.

#Services

text

liquet.tech       → Vercel landing, docs, dashboard
api.liquet.tech   → 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.liquet.tech/health
curl -I https://liquet.tech
curl -I https://liquet.tech/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