Adding an Edge
New edge devices must be registered in the SecureLink orchestrator before they can be deployed and managed. This page walks you through the process of adding an edge to your tenant.
Step 1: Open the Add Edge Modal
Navigate to Equipment > Edges and click the Add Edge button in the top-right corner of the page. This opens the edge registration modal.
Step 2: Fill in Edge Details
Complete the following fields in the modal:
| Field | Required | Description |
|---|---|---|
| Name | Yes | A descriptive name for the edge (e.g., "Sydney Office Gateway" or "Warehouse-01") |
| Serial Number | Yes | The unique serial number printed on the physical device or provided by your hardware vendor |
| Model | Yes | The hardware model of the edge device |
| Description | No | Optional notes about the edge's location, purpose, or other relevant details |
The serial number must exactly match the serial number on the physical device. The edge agent uses this serial number during bootstrap to identify itself to the orchestrator. A mismatched serial number will prevent the edge from connecting.
Step 3: Submit
Click Create to register the edge. The modal will close and the new edge will appear in the Pending tab of the Edges page.
What Happens Next
After creating the edge in the orchestrator:
- Pending State: The edge appears in the Pending tab with a "pending" status. It is registered but not yet operational.
- Deployment: The physical edge device must be deployed at its intended location and connected to the network. This is handled outside of the orchestrator UI.
- Bootstrap: The edge device runs its bootstrap process, which connects it to the orchestrator using its serial number and provisions its certificates and initial configuration.
- Approval: A SuperAdmin or TenantAdmin reviews the pending edge and approves it. Once approved, the edge moves to the Active tab.
- Online: After approval and successful bootstrap, the edge begins sending heartbeats and appears as online. It is now ready to receive configuration.
Approval Flow
Pending edges require explicit approval before they become active members of your network:
- SuperAdmin users can approve edges for any tenant
- TenantAdmin users can approve edges within their own tenant
To approve an edge, go to the Pending tab, locate the edge, and click Approve from the actions menu. The edge will move to the Active tab and begin receiving its configuration.