Upgrade

V1 has multiple production migrations over the life of the repo. Do not say “there is one production migration.” There is no veldriq:upgrade command. /install is not an updater.

Steps

1. Backup (database + storage/app + .env).
2. Replace application files from the new package (keep .env). Do not overwrite storage/app with an empty tree.
3. From backend/: composer install --no-dev --optimize-autoloader.
4. php artisan migrate (pending only).
5. Clear caches (config:cache / view:clear as you use them).
6. Restart queue:work (php artisan queue:restart).
7. Verify login, Dispatch, a PDF, and (if used) Field login against the same origin.

Never migrate:fresh, migrate:refresh, or db:wipe on an existing production installation.

If it fails

• HTTP 500 after replace → storage/ or bootstrap/cache not writable, or APP_KEY lost because .env was overwritten.
• Queue still sending old mail templates → worker not restarted.
• Field This app is not compatible with the server → API / sync protocol mismatch; update app and backend together.

Related: Backup · Post-install checks.