Skip to content

Troubleshooting: Updates

A version mismatch is reported

BLUEPRINT_VERSION_MISMATCH means the installed Blueprint version is older than the required pin. FRONTEND_BACKEND_VERSION_MISMATCH means the compiled assets do not match the backend version.

  • Rebuild the frontend assets after an upgrade.
  • Install the matching Blueprint version.
  • Re-run php artisan pterocloud:compatibility.

The upgrade left pending migrations

DB_MIGRATION_PENDING reports unrun migrations. Run php artisan migrate (never migrate:fresh on a live install), then re-check.

Documentation shows the wrong version

Documentation links are version-aware and carry the running extension version. If the version looks wrong, clear the config cache and confirm PTEROCLOUD_VERSION.

Rollback

There is no automated schema rollback. Restore the database backup taken before the update and reinstall the previous extension files.