Registering an MTGE

Before a Shared Gateway can serve tenants, it must be registered in the platform. Registration creates a device record and generates the credentials needed to bootstrap the physical device.

Steps

1. Navigate to Equipment > Shared Gateways.
2. Click the Register MTGE button in the top-right corner.
3. Fill in the registration modal:

Field	Required	Description
Name	Yes	A display name for the gateway (e.g., "Sydney DC Gateway 1")
Serial Number	Yes	The unique serial number of the physical device
Description	No	Optional notes about location, purpose, or hardware specs

4. Click Register to create the device record.

Deployment Credentials

After registration, a dialog displays one-time deployment credentials:

• Deployment Token -- used during the bootstrap process
• Password -- paired with the token for authentication

danger

Copy these credentials immediately. They are displayed only once and cannot be recovered after closing the dialog. If lost, the device must be re-registered.

These credentials are entered during the MTGE bootstrap process on the physical device. They authenticate the device to the orchestrator so it can download its initial configuration and establish MQTT connectivity.

After Registration

The newly registered MTGE appears in the Pending tab on the Shared Gateways page. It will remain in the pending state until:

1. The physical device is bootstrapped using the deployment credentials.
2. The device connects to the orchestrator via MQTT.
3. An administrator approves the device.

See Approving an MTGE for the next step.