Skip to content
Cnone-Tech Documentation

VPS

Cnone-Tech DocsVeldriq

Recommended production shape (Tier C): HTTPS, cron every minute, and a persistent queue worker. This page is not a substitute for general Linux administration. No single distribution is required. nginx/Apache and systemd snippets in the ZIP manual are examples. Veldriq does not install PHP, nginx, MySQL, cron, Supervisor, or TLS certificates. /install only configures the application after those exist.

Redis is optional. Docker application deploy is not supported.

What you must provide

Section titled “What you must provide”
  • PHP 8.4 FPM and a matching PHP 8.4 CLI (web and CLI can otherwise disagree)
  • Hard extensions including curl and fileinfo
  • MySQL 8.x or MariaDB; document root backend/public; HTTPS
  • Writable backend/storage/ and backend/bootstrap/cache/ for the PHP-FPM user. Never chmod -R 777
  • Composer (ZIP has no vendor/). Frontend public/build is included
  • Cron every minute + a process manager for queue:work

Architecture

Section titled “Architecture”
  1. Browser → TLS → nginx or Apache → backend/public/index.php
  2. Application → MySQL/MariaDB
  3. Cron → php artisan schedule:run (every minute)
  4. Persistent worker → php artisan queue:work (mail, PDFs, webhooks)
  5. SMTP via Platform Admin → Settings → Mail / SMTP
  6. storage/app for uploads; public/storage symlink

Install sequence

Section titled “Install sequence”
  1. Empty database. Schema + user with ALL on that database only. Not MySQL root in .env.
  2. Unpack ZIP, Composer, then Web Installer or CLI. Working directory is the folder that contains artisan (backend/).
  3. Document root = backend/public. Front controller / rewrite so unknown paths hit index.php.
  4. Certificate on the vhost or load balancer. Set APP_URL=https://….
  5. Scheduler:
Terminal window
* * * * * cd /path/to/veldriq/backend && /usr/bin/php artisan schedule:run >> /dev/null 2>&1

Use the PHP 8.4 CLI path your OS actually installed. Verify: php artisan schedule:list then php artisan schedule:run.

  1. Persistent queue worker. A manual php artisan queue:work in SSH is only for testing — closing SSH stops it. After every application file update:
Terminal window
cd /path/to/veldriq/backend
php artisan queue:restart
  1. Mail, license, backups, post-install checks. Confirm cron and the worker still run after a reboot.

Logs in storage/logs. Do not paste secrets into tickets. Do not hard-code author hostnames.

Related: cPanel · Backup · Upgrade.