Requirements & hosting
Application requirements
| Component | Requirement |
|---|---|
| PHP | 8.4 or a compatible later version accepted by the supplied Composer lockfile |
| Composer | 2.x; verify with composer check-platform-reqs --no-dev |
| PHP extensions | All extensions required by composer.lock; commonly curl, PDO/MySQL, zip, mbstring, XML/DOM, fileinfo and OpenSSL |
| Database | MySQL; choose a maintained version and validate migrations on that exact version |
| Web server | Nginx or Apache with its document root set to backend/public |
| Frontend build | Node.js compatible with the locked Vite dependencies; use Node 22 LTS for the build environment |
| Background services | A scheduler every minute and a persistent worker for asynchronous jobs |
| HTTPS | Required for a customer-facing deployment |
| Real-time features | Persistent Reverb process and WebSocket proxy when enabled |
The backend README's MySQL 5.7 and Node 18 entries are historical minimums, not a current hosting recommendation. The supplied lockfiles and target-platform validation are authoritative.
Choose your hosting
| Platform | Confirm with the provider |
|---|---|
| Linux VPS | Compatible PHP/CLI, database, SSH, cron, web server and process manager |
| cPanel / Plesk | Compatible web and CLI PHP, Composer/SSH, configurable document root, cron and persistent workers |
| Shared hosting | All requirements above; many plans cannot run workers or WebSockets |
| Windows / IIS | PHP/MySQL compatibility, URL rewriting, scheduling and service management; separate acceptance required |
Prefer a VPS for live chat, calls and other real-time features. Cloudflare DNS/proxy does not provide a PHP runtime or MySQL database.
Verification status
Fresh-installation acceptance on cPanel, Linux VPS, Plesk/Apache and Windows remains pending. Local regression tests do not certify these hosting environments.