Getting started

Qcentic Edge ships as one hardened Docker image plus three Compose stacks. From zero to a running app: clone the template, copy .env.docker.dev.example to .env.docker.dev, fill in APP_KEY, and bring up the dev stack with docker compose -f docker-compose.dev.yml --env-file .env.docker.dev up -d. The app is on :8090, the admin panel on /admin, and Vite HMR on :5173. Create your first admin user with the seeder + a tinker one-liner (roles super_admin / user are seeded for you). On a stateless host (bunny.net Magic Containers) use the web installer at /install instead of the shell, then retire it with INSTALLER_ENABLED=false.

The local stack is Compose, not bare php artisan serve. The libSQL PHP client loads a glibc native library through FFI, and the dev stack runs sqld, MinIO, and Reverb sidecars that the app expects on localhost. artisan serve cannot provide those, so use the image.

Next

• Local development — dev Compose stack, ports, first admin user, test commands.
• First-run installer — /install checklist, the DB lock, retiring the installer on a stateless host.
• Environment variables — the env contract: APP_KEY, DB_URL, AWS_*, Passport PEMs, INSTALLER_ENABLED.

See also

• Local development
• First-run installer
• Environment variables