Deploy#

Run the FastAPI runtime and Next.js dashboard as separate supervised services behind an HTTPS reverse proxy. Keep SQLite on durable local storage and allow only one runtime instance to write to it.

Before you start#

• A Linux or Windows host sized for both services and provider traffic.
• A DNS name and valid HTTPS certificate.
• A durable data directory and off-host backup destination.
• Production Telnyx and voice-provider credentials.
• Unique, randomly generated authentication and session secrets.

Production sequence#

1. Build and test a pinned source revision.
2. Install production dependencies and create a private .env owned by the service account.
3. Place the SQLite database on persistent storage.
4. Run database seeding only for a new installation; migrations run at startup.
5. Build the dashboard with its final public and runtime URLs.
6. Start one runtime process and the dashboard under a service manager.
7. Proxy the public origin over HTTPS and restrict direct service ports.
8. Route Telnyx callbacks only after readiness is healthy.

The runtime rejects oversized HTTP requests according to MAX_REQUEST_BODY_BYTES; keep an equivalent or stricter proxy limit. Never expose development password bypasses or fake providers in production.

Verify#

Check /api/health, then /api/ready. Sign in through the public dashboard, place a controlled inbound call, and confirm webhook, media, transcript and notification completion. Finally, create and restore a backup in a disposable environment before declaring the service operational.

If it does not work#