OpenWrt

Nexus Telemetry Fleet supports OpenWrt 24.10 and 25.12 on ARM and x86-64 routers. OpenWrt 24.10 installs the collector with opkg, and OpenWrt 25.12 with apk. See Routers for the requirements.

The recording shows the collector installed through LuCI, OpenWrt’s web interface, and enrolled on a GL.iNet Beryl AX. See LuCI upload for the steps.

Supported firmware

Firmware Package manager Processor
OpenWrt 24.10 opkg 64-bit ARM, 32-bit ARM with hardware floating point, x86-64
OpenWrt 25.12 apk 64-bit ARM, 32-bit ARM with hardware floating point, x86-64

Command line

Open an SSH session to the router as root, with the router’s admin password.

bash
ssh root@<router address>

Install on OpenWrt 24.10

Replace <channel> with the fleet server’s release channel.

bash
wget -O /tmp/nexus-fleet-feed.ipk https://fleet-downloads.nexustelemetry.com/openwrt/<channel>/nexus-fleet-feed.ipk && opkg install /tmp/nexus-fleet-feed.ipk && opkg update && opkg install nf-collector

On a router where the collector is not yet enrolled, the install ends with Nexus Telemetry Fleet collector installed. and the enrolment steps.

Install on OpenWrt 25.12

The apk package manager cannot install a package from a URL. The command downloads the feed package first. The feed package is not signed. apk accepts it only with --allow-untrusted. The feed package installs the feed’s signing key. apk checks every later install and update against that key. Replace <channel> with the fleet server’s release channel.

bash
wget -O /tmp/nexus-fleet-feed.apk https://fleet-downloads.nexustelemetry.com/openwrt/<channel>/nexus-fleet-feed.apk && apk add --allow-untrusted /tmp/nexus-fleet-feed.apk && apk update && apk add nf-collector

On a router where the collector is not yet enrolled, the install ends with Nexus Telemetry Fleet collector installed. and the enrolment steps.

LuCI upload

LuCI installs the same packages without a command line.

  1. Download the feed package for the router’s OpenWrt version from the Routers card in the Add telemetry collector window.
  2. Open System, then Software, in LuCI.
  3. Upload the feed package with Upload Package.
  4. Update the package lists.
  5. Filter the list for nf-collector.
  6. Install nf-collector.

Enrol

Enrol the collector from a browser at http://<router address>:41700, or with the enrol command. See Routers for the steps.

Firmware upgrades

A firmware upgrade with Keep settings keeps the collector, its device certificate and its record. The collector starts again after the upgrade, with or without a connection. It is still enrolled. About 2 minutes after the upgrade, the router’s package list includes the collector again. The collector updates from the feed as before. An upgrade without Keep settings removes the collector and its device certificate. Install and enrol it again.