# 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](/books/gatebeacon-documentation/page/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](/books/gatebeacon-documentation/page/prerequisites).

## Next Steps

With your device online, you can:

- Install a ready-made application from the catalog — see [Other Catalog Applications](/books/gatebeacon-documentation/page/other-catalog-applications).
- Publish an application you already run on the device — see [Publishing an App over HTTPS](/books/gatebeacon-documentation/page/publishing-an-app-over-https).