Skip to content

Connect & Register the Edge Appliance

This guide covers on-site work: mounting and cabling the appliance, opening SSH, and registering with monozu edge register. Pairing the device to your tenant is completed by Monozu — see Claim Code Pairing for what your administrators verify in the cloud UI.

ItemDetails
NetworkOutbound HTTPS to cloud.monozu.io and api.cloud.monozu.io; WireGuard UDP to your VPN Hub hostname
CredentialsSSH username/password or key provided with the appliance by Monozu
TenantYour organization must already exist in Monozu Cloud — Monozu pairs the claim code to your tenant
On-site actorMonozu technician (typical) or your OT engineer with Monozu delivery credentials
  1. Mount the appliance per Monozu delivery documentation.

  2. Connect power and wait for boot (first start may take several minutes).

  3. Connect network cables:

    • WAN / uplink — path to internet or corporate egress.
    • LAN — OT/IT VLAN for discovery or protection (one appliance per isolated segment is typical).
  4. Confirm outbound access to cloud.monozu.io, api.cloud.monozu.io, and your VPN Hub hostname (Network & Connectivity).

2. Access the device (SSH or local console)

Section titled “2. Access the device (SSH or local console)”
  1. Obtain the appliance IP address (DHCP reservation, label, or temporary console display).

  2. Connect using credentials from your Monozu delivery packet:

    Terminal window
    ssh <username>@<appliance-ip>
  3. If SSH fails, verify management VLAN access, power, and site firewall rules allowing SSH to the appliance on your network.

Attach a display and keyboard if required. The registration command below runs the same from SSH or console.

  1. On the appliance, run:

    Terminal window
    monozu edge register
  2. Complete any network setup prompts (WAN/LAN, DHCP or static IP) if shown.

  3. Note the claim code displayed on the console (short code, e.g. ABC-123). Share it with Monozu if your rollout process requires it.

  4. Wait while Monozu completes pairing to your tenant. The CLI finishes automatically when pairing succeeds.

  5. In Monozu Cloud, your administrator opens Edge Devices and confirms status Online (Claim Code Pairing).

  6. Enable optional modules (VPN, backup, security) per your License and module documentation.

TaskWhere
Verify connectivityEdge Devices — status Online
DiscoveryAssets / CMDB — hosts after scan (Asset Discovery)
Site / zonesAssets — link discovered assets to sites and zones
VPN / backup / securityCloud UI modules per license
ProblemWhat to try
Cannot SSHCheck IP, cable, VLAN, local ACLs; use console
monozu command not foundContact Monozu support — image may need recovery
Claim code expiredRe-run monozu edge register; contact Monozu if pairing was delayed
Device Offline in cloudFirewall/proxy blocking outbound HTTPS; see Network & Connectivity
Discovery emptyLAN on correct interface; licensed module; wait for scan interval