Installation

Requirements

• PHP ≥ 8.2 with pdo_pgsql or pdo_mysql, mbstring, openssl, gd, fileinfo
• PostgreSQL 14+ or MySQL 8.0+
• HTTPS (required for camera access in the hosted flow)

Web installer (recommended)

1. Upload the package files to your web root.
2. Point your domain/vhost at the public/ directory.
3. Visit https://your-domain.com — you'll be redirected to the setup wizard.
4. Wizard steps: requirements check → database → owner account & brand → provider → done.

Command line (advanced)

composer install --no-dev
cp .env.example .env
php artisan key:generate
php artisan migrate --force
php artisan db:seed --force --class=DefaultSettingsSeeder
php artisan storage:link

Then create your owner account via the wizard at /install (it detects the migrated database and only asks for account + provider).

Cron (required for scheduled jobs)

* * * * * cd /path/to/app && php artisan schedule:run >> /dev/null 2>&1

This drives webhook retries (every 5 min) and the retention purge (daily 03:00).

Post-install checklist

• Settings → Branding: upload logo, set colors
• Settings → Landing: customize the public page copy
• Providers: connect Didit or iDenfy (or stay on Demo Mode while building)
• API Keys: create your first key
• Webhooks: register your backend endpoint and store the signing secret