Back to DocsRecipe

Recipe: Safe model rollback procedure

Step-by-step guide to reverting a Meridian model deployment without data loss or downtime.

Prerequisites

  • At least two prior successful deployments in the target environment.
  • Rollback snapshot created during the last stable deploy.
  • Write access to the Meridian dashboard for the target project.

Step 1 — Locate the snapshot

Navigate to Project → Deployments. Each row shows a timestamped snapshot. Identify the last known-good entry by its green verified badge.

Step 2 — Dry-run validation

Click the snapshot row and select Dry Run. Meridian will diff the snapshot against the live model and report schema, weight, and config deltas without mutating production.

Step 3 — Execute rollback

After confirming the dry-run output, press Rollback. The platform atomically swaps the active model pointer. In-flight requests drain against the current model for up to 30 seconds before the switch completes.

Step 4 — Verify

Check the Health tab. Latency and error-rate panels should return to baseline within two minutes. If metrics remain degraded, escalate to the on-call channel immediately.

Note: Rollbacks are idempotent. Re-running the same snapshot will not double-apply. Snapshots are retained for 90 days on paid plans.