Core Upgrades

LaraDashboard includes a built-in Core Upgrades workflow for checking marketplace updates, creating backups before upgrades, and applying new core versions from the admin panel.

Access#

Navigate to More → Settings → Core Upgrades (/admin/core-upgrades).

Requires the settings.view permission (Superadmin and Admin roles typically have this).

---

What you see#

Card	Description
Current Version	Installed core version (from version.json, e.g. v1.4.2)
Update Status	Whether a newer version is available from the marketplace
Backups	List of created backup archives
Upgrade actions	Upload or apply a core update package

The scheduler runs core:check-updates --silent twice daily to refresh update availability.

---

Create a backup#

Always create a backup before upgrading.

1. Click Create Backup
2. Choose backup type:
   • Core with modules — core files and module directories
   • Core only — core application files
3. Optional: include database and/or vendor directory
4. Confirm and wait for completion
5. Download the archive from the backups list when ready

Backups are stored on the server disk configured for your installation (typically storage/app/).

Tip: For production, also maintain off-site database dumps. See Backup & Restore for manual and scheduled strategies.

---

Apply an upgrade#

When an update is available:

1. Review the release notes on the Core Upgrades page
2. Create a fresh backup
3. Click Upgrade (or upload a core ZIP if provided manually)
4. Wait for the upgrade process to finish
5. Verify the site loads and run smoke tests

If something goes wrong, use Rollback when a pre-upgrade snapshot is available, or restore from your backup archive.

---

CLI equivalents#

Developers and DevOps can run the same workflow from the terminal:

Command	Purpose
php artisan core:check-updates	Check marketplace for new core version
php artisan core:snapshot	Create pre-upgrade snapshot
php artisan core:upgrade	Apply core upgrade
php artisan core:verify	Verify installation after upgrade
php artisan core:rollback	Roll back to previous snapshot
php artisan core:zip	Package core for release (maintainers)

See Core Release Commands for maintainer details.

---

Permissions#

Permission	Access
settings.view	View Core Upgrades page and backups
settings.edit	Create backups and apply upgrades

---

Troubleshooting#

Upgrade fails mid-process#

1. Check storage/logs/laravel.log
2. Run php artisan core:verify
3. Use rollback or restore from the latest backup archive

No update shown but a release exists#

1. Confirm MARKETPLACE_URL in .env points to the correct marketplace
2. Run php artisan core:check-updates manually
3. Verify outbound HTTPS from the server

---

Next steps#

• Backup & Restore — manual DB and file backup strategies
• Deployment Guide — production deployment
• Troubleshooting — common post-upgrade issues