Rollback
Revert your fleet to a previous model version when a deployment causes issues. Rollbacks are instant -- devices switch to the previous version on their next sync.
Quick rollback
- CLI
- Python
- cURL
octomil rollback phi-4-mini --to-version 1.0.0
Rollback initiated
Model: phi-4-mini
From: v2.0.0 → To: v1.0.0
Affected devices: 124
Status: rolling_back
from octomil import OctomilClient
client = OctomilClient(api_key="edg_...")
rollback = client.rollouts.rollback(
model_id="phi-4-mini",
to_version="1.0.0",
reason="Latency regression detected",
)
print(f"Rolling back {rollback.affected_devices} devices")
curl -X POST https://api.octomil.com/v1/models/phi-4-mini/rollback \
-H "Authorization: Bearer edg_..." \
-H "Content-Type: application/json" \
-d '{"to_version": "1.0.0", "reason": "Latency regression detected"}'
When to rollback
- Quality regression -- accuracy or relevance dropped after a model update
- Latency spike -- inference time increased beyond acceptable thresholds
- Crash rate increase -- model causes crashes on certain device classes
- Memory issues -- new version exceeds device memory on target hardware
Rollback during an active rollout
If a rollout is in progress, rolling back reverts all devices (including those already on the new version):
# Rollout is at 40%
octomil rollout status phi-4-mini
# Progress: 40% (50 of 124 devices)
# Rollback everything
octomil rollback phi-4-mini --to-version 1.0.0
# All 124 devices revert to v1.0.0
The active rollout is cancelled automatically.
Rollback to any version
You can rollback to any previously deployed version, not just the immediately prior one:
# List version history
octomil models versions phi-4-mini
# Rollback to a specific version
octomil rollback phi-4-mini --to-version 0.9.0
Auto-rollback
Configure automatic rollback when error thresholds are exceeded:
octomil team set-policy --auto-rollback --error-threshold 5%
With auto-rollback enabled, Octomil monitors deployment health and reverts automatically if:
- Error rate exceeds the configured threshold
- Crash rate spikes above baseline
- Latency p95 degrades beyond the configured limit
See Policy for configuring auto-rollback rules.
Scoped rollback
Rollback a specific device group instead of the entire fleet:
octomil rollback phi-4-mini --to-version 1.0.0 --group staging
Verify rollback
After initiating a rollback, confirm all devices received the previous version:
octomil rollout status phi-4-mini
Model: phi-4-mini
Active version: v1.0.0
Rollback from: v2.0.0
Status: completed
Devices on v1.0.0: 124/124 (100%)
Related
- Rollouts -- gradual deployment to reduce rollback risk
- Policy -- auto-rollback rules and quality gates
- Benchmarks -- catch regressions before deploying