TripNova Docs
Update Flow

Updating TripNova Safely

Use this flow when applying a new TripNova release or replacing bundled add-ons.

Before Updating

  • Back up the database and uploaded files.
  • Download the current .env and any custom theme or integration files.
  • Run php artisan tripnova:pre-update-check from the current installation.
  • Review the changelog for migrations, add-on changes, and manual actions.

Update Steps

  1. Enable maintenance mode with php artisan down.
  2. Replace changed source files. Do not overwrite .env or local uploads.
  3. Run composer install --no-dev --optimize-autoloader unless using the shared-hosting ZIP.
  4. Run php artisan migrate --force.
  5. Run php artisan optimize:clear and php artisan optimize.
  6. Disable maintenance mode with php artisan up.

Add-on Updates

Update add-ons after the main application is updated. Copy the package source, run Composer if needed, publish new migrations or config only when the changelog says so, and run migrations once.

Rollback

If a deployment fails, restore the source backup and database backup together. Do not roll back only files after a migration has changed production data. Keep maintenance mode enabled until the admin dashboard, public portal, and payment webhooks are confirmed.