Upgrade and repair

How packaged upgrades preserve Portivo data and reconcile operational state.

Windows update / repair

Run the newer Install Windows.cmd package again. The installer detects the existing installation, stops the service, creates a safety backup, updates the application, refreshes dependencies, applies database migrations, repairs service configuration when required and performs a health check.

Linux update

Run the newer Linux installer. It creates a safety backup, refreshes the application and Python environment, applies migrations and restarts systemd.

Preserved data

Normal upgrades preserve the database, .env, logs and backups.

Interrupted Jobs

At startup, Portivo reconciles orphaned queued, running or cancelling Jobs from a previous process into an interrupted lifecycle state rather than leaving them falsely active. Already successful Job items are preserved.

Before upgrading

1. Export or otherwise back up the Portivo database.
2. Keep the current APP_SECRET_KEY. Changing it breaks decryption of stored integration/credential secrets.
3. Read the release history for migrations and behavioral changes.
4. Use the checksum file to verify the release artifacts.