Troubleshooting
| Symptom | Fix |
|---|---|
| Blank page / 500 | Check storage/logs/laravel.log; ensure APP_KEY set |
| Extensions missing | Enable for the same PHP version as the vhost |
| Cannot write storage | chown/chmod for PHP-FPM user on storage, bootstrap/cache |
| DB connection failed | Empty DB exists? Host 127.0.0.1? User privileges? |
/install → login |
Already installed (installed.lock). Remove only to reinstall |
| Assets broken | Upload public/build including manifest.json |
| Queue / mail stuck | Cron not running; or start queue:work |
| Reports never email | Cron + mail config + reports feature + reports.export |
| Widget/kiosk blank | Campaign must be active; check browser console / mixed content |
| License features missing | pulsevia:license-status / revalidate; confirm domain |
| Update signature failed | Wrong UPDATE_PUBLIC_KEY or tampered package |
| 403 in demo | Expected for blocked actions — see Demo |
| SPA route 404 | Ensure web route exists for the path (auth shell routes are registered in routes/web.php) |
| Permissions wrong | Re-seed roles: php artisan db:seed --class=RolesAndPermissionsSeeder --force |
Still stuck? Contact support with log excerpts (redact secrets) via the site contact form.