Decommissioning a Connector
When a connector is no longer needed -- whether the site is closing, hardware is being replaced, or the device is being retired -- it should be decommissioned through the platform.
Steps
- Navigate to Equipment > Connectors.
- Click on the connector you want to decommission to open its detail page.
- Click the Decommission button.
- Confirm the action in the confirmation dialog.
What Decommissioning Does
When a connector is decommissioned, the following actions occur:
| Action | Details |
|---|---|
| Status update | The connector's status is set to "decommissioned" |
| Hub edge cleanup | The connector's WireGuard peer is removed from the hub edge |
| Hub edge re-sync | The hub edge is marked as dirty and receives an updated configuration without this connector's peer |
| Config updates stop | The connector stops receiving configuration updates from the orchestrator |
Decommissioning is irreversible. Once a connector is decommissioned, it cannot be reactivated. If you need connectivity at the same site again, you must register a new connector.
Audit Trail
The decommissioned connector entry remains in the system for audit and record-keeping purposes. It will appear in the connectors list with a "decommissioned" status but will no longer be counted in the active, online, or offline statistics.
Before You Decommission
Before decommissioning, consider the following:
- Verify the device is no longer needed. Any sites relying on this connector for connectivity will lose access immediately.
- Check for dependent routes. If other parts of your network route traffic through this connector, update those routes before decommissioning.
- Document the reason. While the platform retains the record, keeping your own notes about why a device was retired helps with future audits.
If a connector is temporarily offline and you expect it to return, do not decommission it. Connectors automatically transition back to "active" when they resume sending heartbeats. Decommissioning should only be used for permanent removal.