How do I decommission an instance?

Who can do this

Platform Admin or Infra Ops

Decommissioning takes an instance out of service so tenant placement stops sending traffic to it. It's a soft-delete — the record remains for audit, but the instance is excluded from operational dashboards.

Steps

1. Make sure no active tenants remain on the instance. Open Instances → <instance> → Tenants and migrate or delete everything still there.
2. From the instance detail page, click Decommission in the actions menu.
3. Type the confirmation string and click Confirm.

Result

• The instance moves to status Decommissioned.
• New tenants cannot be created on it.
• The instance is hidden from the default Instances view (filter by Decommissioned to see it).
• Heartbeats are no longer expected — the underlying stack can be torn down.

Decommissioning blocks new traffic, not running tenants

If any tenants are still on this instance, decommission does not stop them from serving requests. You must move or delete tenants first.

Related

• How do I create a new instance?