Skip to content

Update Commands ​

Update commands patch host-application configuration files to align with Modularous requirements during installation or version upgrades. They perform surgical, reversible edits to keep your config/*.php files compatible — they don't overwrite your customisations.

Internal commands

All Update commands have $hidden = true and are not listed in php artisan list. They are invoked automatically by modularous:install and by the upgrade guide, but you can run them manually when something drifts.

CommandDescription
modularous:update:laravel:configsPatch config/auth.php and optional config files for Modularous guards

When to Run These Manually ​

SymptomLikely fix
Login page rejects valid credentials with "guard not defined"php artisan modularous:update:laravel:configs
Fresh clone missing Modularous guards in config/auth.phpphp artisan modularous:update:laravel:configs
Upgraded Modularous and release notes mention new guards / providersphp artisan modularous:update:laravel:configs

Always diff config/auth.php against git before committing after running an Update command — the patch is transparent, but you should understand what changed.

  • Upgrading — the primary context for Update commands
  • Setup / install — invokes Update commands automatically on first install