First administrator

The ZIP does not contain a login. The Web Installer creates the first platform administrator and first workspace during the Administrator and workspace step. On a VPS you may instead run php artisan veldriq:install after migrate.

There is no installer reset. If you lost that user, restore from backup — do not invent a migrate:fresh on production.

CLI install does not write .env, does not migrate, and does not activate the license. Prefer the Web Installer unless you already manage .env yourself.

Web Installer fields

Screen: Administrator and workspace. Fields: first name, last name, email, password, confirm password, workspace / company name, optional slug, default currency (EUR, USD, GBP, XOF, or XAF).

Password rules match the rest of Veldriq (typically at least 8 characters, mixed case, and a number). Sign in after Complete at /login with only that email and password.

That user is the platform super-admin. They can open Platform Admin, including License & Products. Workspace members created later cannot manage marketplace licenses.

What a successful fresh install creates

• System catalogues (roles, plans, permissions, supported languages)
• Your first administrator (platform owner)
• Your first workspace, with starting work-order types, service-request categories, payment methods, currencies, English enabled, and core capabilities
• Veldriq Web license activated — only if you used the Web Installer (CLI does not activate a license)

Do not treat exact row counts as a product guarantee.

CLI (VPS / recovery)

Working directory is always backend/. This command does not migrate and does not activate a license.

cd backend
php artisan veldriq:install

Prompts: administrator email, password (hidden), first name (default Owner), last name (default Admin), workspace name (default My Company).

Non-interactive flags exist (--email, --password, --tenant-name, --tenant-slug, --no-interaction). Environment variables VELDRIQ_INSTALL_* map to the same keys. Do not commit the password. Pass --no-storage-link to skip storage:link.

If you run CLI again

Situation	Result
Unknown email, no super-admin yet	Creates the user, workspace, and platform access
Same email is already a super-admin	Success. Identity and password are not changed. This is not a password reset
Email exists but is not a super-admin	Refuses. Promote later with php artisan platform:promote their@email
A different super-admin already exists	Refuses. Use platform:promote for extra platform users

Installed lock

The Web Installer is locked when at least one platform super-admin exists. Revisiting /install returns HTTP 404.

Veldriq prevents removal of the final super administrator in the supported account flow. Do not try to unlock install by editing the database.

Related: License · Post-install checks.