Updating

When a new version of WhatsMine is released, follow these steps to update safely.

Before you start

php artisan db:backup
cp .env .env.backup

Update steps

1. Put the app in maintenance mode (optional but recommended):

   php artisan down
   

2. Replace the application files with the new version. Be careful not to overwrite:

   • your .env file
   • your storage/ directory (uploads, logs, invoices)
   • any custom code you've added

   If you use git, git pull handles this for you.

3. Update dependencies:

   composer install --no-interaction --prefer-dist --optimize-autoloader --no-dev
   npm ci
   

4. Run new migrations:

   php artisan migrate --force
   

5. Rebuild the frontend:

   npm run build
   

6. Refresh caches and restart workers:

   php artisan config:cache
   php artisan route:cache
   php artisan view:cache
   php artisan event:cache
   php artisan queue:restart
   

7. Bring the app back online:

   php artisan up
   

After updating

• Check Admin → Cron Setup that the scheduler heartbeat is still green.
• Check Admin → Queue for failed jobs.
• Do a quick smoke test: log in, open the inbox, send a message.

Translations note

If an update adds new interface text, seed any new translation keys and refresh the translation cache:

php artisan i18n:scan

New languages and edits are managed in Admin → Languages. See i18n.

Rolling back

If an update causes problems:

1. Restore your previous application files.
2. Restore the database backup you took.
3. Run composer install and npm run build for the old version.
4. php artisan up.