Table of Contents
Self-hosted gives you control over model lifecycle — including how long to keep an old model serving. Hosted APIs deprecate on their schedule; self-hosted lets you choose. The discipline is to have a strategy, not just "forever, until it falls over".
Deprecate a self-hosted model when: a meaningfully better successor exists, security / licence requires it, or maintenance burden exceeds value. Standard timeline: announce 90 days out, migrate consumers over 60 days, sunset 30 days after final cutover. Bridge with eval harness comparison + dual-running window.
When to deprecate
- Better successor: new model with measured quality lift on your eval harness
- Security: known vulnerability in older model / framework version
- Licence change: original licence becomes incompatible with your use
- Maintenance burden: increasingly hard to keep running on current GPU / driver / vLLM versions
- Cost: better cost economics on a newer / smaller model
Plan
Standard deprecation timeline:
- T-90 days: announce deprecation; document migration path; offer office hours for affected teams
- T-60 days: dual-run old + new in production; eval harness compares
- T-30 days: route 50% traffic to new model; monitor
- T-7 days: route 95% to new; old kept warm
- T-0: cutover complete; old version stays warm for emergency rollback
- T+30 days: decommission old version
Migration
- Eval harness comparison: new model meets / exceeds quality bar on representative tasks
- Prompt template changes: some models need different prompt patterns; document + provide examples
- API contract: keep external API contract stable; absorb model-specific differences server-side
- Performance characteristics: latency, cost, throughput differences communicated to consumers
Verdict
Self-hosted gives you control over model lifecycle — use it. Document a deprecation strategy, communicate timelines, dual-run during cutover, keep eval harness honest. The discipline pays off when consumers trust your migration cadence and infrastructure stays maintainable long-term.
Bottom line
Documented sunset is better than "until it breaks". See rollout pattern.