cPanel

Veldriq-specific path from the commercial ZIP to a usable production site on a typical cPanel account. Hosting dashboards use different labels — those names below are generic. The Veldriq requirements (document root, PHP 8.4, Composer, cron) do not change.

The commercial package does not include vendor/. You must run Composer from cPanel Terminal or SSH. Compiled frontend assets (backend/public/build) are included — Bun is not required on the host. Redis is not required. This does not claim every shared host works.

Is this host capable?

Item	Need
Terminal or SSH	Required — File Manager can upload; it cannot run Composer
Composer 2	Required — composer install --no-dev --optimize-autoloader from backend/
PHP CLI 8.4	Required — same major version as the site. Cron must call this binary
Cron Jobs	Required for production (Tier B). Cadence is every minute
Persistent Supervisor	Not required — use the cron drain
Redis	Not required

If any REQUIRED item is missing, use a VPS instead.

Steps

1. Extract locally so you know the layout: backend/, documentation/, START-HERE.txt. The only public directory is backend/public.
2. Upload the tree above the public web root, then extract. Do not publish the ZIP root as the website.
3. Point the domain at Laravel public: Domains (or Addon / Subdomains) → Document Root → …/backend/public. Never the ZIP root, never backend/, never storage/ — that would expose .env.
4. Select PHP 8.4 (commonly MultiPHP Manager). Enable hard extensions: ctype, curl, mbstring, openssl, pdo, pdo_mysql, tokenizer, xml, json, bcmath, fileinfo. Recommended: gd or imagick, intl, zip.
5. Create the database (MySQL 8.x or MariaDB). Record host (often localhost), port, name, username, password. Then continue in the Web Installer Database step.
6. Writable paths: backend/storage/, backend/bootstrap/cache/, and the ability to create backend/.env. Do not use chmod -R 777.
7. Composer:

cd /path/to/backend
composer install --no-dev --optimize-autoloader

8. HTTPS (AutoSSL). APP_URL must be that https:// origin.
9. Open https://your-domain.example/install. /install does not add cron.
10. Cron every minute (Tier B). Use the PHP 8.4 CLI binary the host documents:

* * * * * cd /path/to/backend && /path/to/php artisan schedule:run >> /dev/null 2>&1
* * * * * cd /path/to/backend && /path/to/php artisan queue:work --stop-when-empty --tries=3 --timeout=90 >> /dev/null 2>&1

On cPanel that path is often the account home plus your extract folder. Replace /path/to/backend and /path/to/php with the real application path and the PHP 8.4 CLI the host documents.

The second line is the supported cPanel queue: a bounded drain, not Supervisor.

Common mistakes

Document root = ZIP root; PHP 8.2; no cron; expecting Docker; web Composer button.

Related: VPS · Queue · Scheduler.