Skip to main content
Version: 0.9.12

delphi-setup CLI reference

platform v0.9.11verified 2026-05-14

delphi-setup is the setup registry CLI shipped on PATH in the voiceai-telweb image (/usr/local/bin/delphi-setup). It runs idempotent setup phases for first use, updates, and optional dev-only seed data. Every step is safe to re-run and reports whether it made a change or noop'd.

Automatic vs manual

TelWeb start applies schema with Prisma migrate deploy, then runs the baseline seed via prisma db seed. Registry steps driven by delphi-setup (interactive superuser, update-only steps, dev-only bundles) do not run automatically — see First use on TelWeb for the bring-up order.

CLI flags​

FlagBehaviour
(none)Interactive wizard — every applicable phase prompts as needed (stdin/stdout must be a TTY).
--apply-missingRun only setup steps introduced or updated since last run — typical after ECR_TAG bumps.
--dev-seedsInclude dev-only seed data (requires -it; aborts otherwise).
--non-interactiveNo prompts — answers come from environment variables.
--force-step <stepId>Re-run a single keyed step — e.g. firstUse.superuser.

Production invocation​

From the Web host:

cd /opt/services/web

# First login / onboarding (interactive)
docker compose exec -it voiceai-telweb delphi-setup

# After upgrading the TelWeb image
docker compose exec -it voiceai-telweb delphi-setup --apply-missing

# Automation (no TTY)
docker compose exec voiceai-telweb delphi-setup --non-interactive

# Dev/demo data — interactive only
docker compose exec -it voiceai-telweb delphi-setup --dev-seeds

What the registry covers​

The registry includes (non-exhaustive):

  • Register built-in provider catalogues (OpenAI, Azure, Pythia, Vodafone TOBi).
  • Seed Flow Builder templates where applicable.
  • Apply default surfaces for Feature flags.
  • Platform-settings rows used for billing, registration, notifications, and onboarding.
  • First-use: platform superuser and other guarded steps keyed under firstUse.*.
  • Update migrations outside Prisma's schema migrations when a release introduces them.

Each step persists progress in Postgres; failures print the failing step. Fix the root cause and run delphi-setup again.

Output​

delphi-setup
✓ provider-catalogue        already current
✓ flow-templates            seeded 4 new templates
✓ feature-flag-defaults     already current
✓ platform-settings         seeded 2 new keys
✓ legal-consents            already current

5 steps, 2 changed, 3 noop

Operator notes​

  • Re-running after a flag change may be necessary to reconcile defaults — coordinate with Feature flags.
  • Registry steps are not user-extensible; they ride with voiceai-telweb. Persistently failing steps need support from whoever ships your images.

See also​