Update the script

There is no one-click updater that replaces every file for you. Plan a short maintenance window and keep a backup of .env and the database.

1. Replace application files

Upload the new package over the existing install except .env. Do not overwrite .env or you will lose database credentials, APP_KEY, mail, and queue settings.

2. Run the web updater

Visit:

https://yoursite.com/update

That path syncs the database and related update steps for the packaged release.

3. Clear caches in the browser

Sign in, then open:

https://yoursite.com/dev/setup/clear/all

4. If something is still off (SSH)

php artisan migrate
php artisan optimize && php artisan cache:clear && php artisan route:cache && php artisan view:clear && php artisan config:cache && php artisan route:clear

If you customized Vue or CSS, rebuild assets on a machine that has Node:

yarn install
yarn build

Then deploy the generated files under public/build with the rest of the update.

Settings after a feature release

New default settings rows may not exist on old databases. If a new settings screen looks empty, see Setting seeder.