Skip to main content

Enrolling a Linux Device

Enrolling a Linux Device

This guide walks through connecting a Linux device to GateBeacon. Confirm your distribution is listed in Supported Operating Systems before you begin.

Step 1 — Start the Enrollment Wizard

  1. Log in to the customer portal and go to Devices.
  2. Click Add your device.
  3. On Step 1 — Select device operating system, choose Linux.
  4. Review and check the box agreeing to GateBeacon's Terms & Conditions and Acceptable Use Policy.
  5. Click Next. This generates a one-time enrollment token and moves you to Step 2.

Step 2 — Run the Installation Command

  1. On Step 2 — Installation command, click Copy command to copy the one-line install command to your clipboard.
  2. Open a terminal on the target Linux machine with root or sudo access.
  3. Paste and run the command.

The installer will, in order:

  1. Check IP configuration, internet connectivity, and DNS resolution.
  2. Install required packages (curl, tar, unzip, ufw, iproute2, jq, kmod) and Docker, if not already present.
  3. Register the device with GateBeacon using your enrollment token.
  4. Start the Rathole tunnel client and GateBeacon's background systemd services.

Step 3 — Confirm Enrollment

Back in the portal wizard, Step 3 will show "Congratulations. NovaEdge Device enrolled successfully." once the device checks in. Click Close. Your device now appears in the Devices list with an Online status.

Notes

  • Enrollment tokens are single-use and time-bounded. If the command expires before you run it, go back to Devices and generate a new one.
  • Re-running the installer is safe. If you run the install command again on a device that's already enrolled, it re-uses the device's existing identity and tunnel token rather than creating a duplicate — useful for updating or repairing an existing installation.
  • Cloned VMs: if this device was cloned from another machine's disk image, regenerate /etc/machine-id first — see Prerequisites.

Next Steps

With your device online, you can:

Back to top