Skip to main content

First use on TelWeb (delphi-setup)

platform v0.9.11verified 2026-05-14

Run this step after containers are up and the dashboard responds (see the smoke checks at the end of Bootstrap and init). The TelWeb container does not run delphi-setup for you at start — it runs Prisma migrate deploy and the baseline prisma db seed only. Interactive first-use work (for example creating a platform superuser) and optional dev-only seed data are always done with the setup CLI.

Source of truth in the image

The separation is documented inline in the TelWeb image entrypoint.sh: baseline seed completes before the Next.js server starts; registry steps (firstUse, updates, dev-only phases) run via delphi-setup.

1. Confirm TelWeb finished database bootstrap​

SSH to the Web host, then:

cd /opt/services/web
docker compose logs voiceai-telweb | tail -80

You should see migrations and baseline seed succeeding (✅ Migrations completed, ✅ Baseline seed completed) before 🚀 Starting standalone Next.js server.... First boot can spend most of the healthcheck start period (~40s) in this phase.

If migrations or baseline seed failed, fix Postgres connectivity / DATABASE_URL and redeploy TelWeb — do not run delphi-setup until the entrypoint succeeds.

From the Web service directory:

docker compose exec -it voiceai-telweb delphi-setup

The TelWeb image installs delphi-setup on PATH (/usr/local/bin/delphi-setup). Use -it so the wizard can prompt for things like the initial superuser and any gated first-use steps.

3. After a platform upgrade​

Apply only new or missing registry steps:

docker compose exec -it voiceai-telweb delphi-setup --apply-missing

Re-run whenever you bump ECR_TAG on TelWeb and the release adds setup steps — restarting the container applies migrations, not necessarily every setup step.

4. Optional dev-only data​

Local or test-focused seed bundles need an interactive TTY:

docker compose exec -it voiceai-telweb delphi-setup --dev-seeds

5. Automation / CI — non-interactive​

When stdin is not a TTY, use env-backed answers or force a step:

docker compose exec voiceai-telweb delphi-setup --non-interactive
docker compose exec voiceai-telweb delphi-setup --force-step firstUse.superuser

Next​

  • delphi-setup CLI — flags, phases, troubleshooting, what the registry covers.
  • Web operations — migrations, health checks, HTTPS.
  • Feature flags — some defaults are seeded by registry steps tied to deployment flags.