Home

How to find the correct package and install it to your router

Identify Your Platform Using /etc/openwrt_release

Usteer‑NG packages are built for specific OpenWrt CPU architectures
(for example: mips_24kc, aarch64_cortex-a53, arm_cortex-a7_neon-vfpv4, x86_64).

To install the correct package, you must know your device’s architecture, not only its model or OpenWrt target.

One of the simplest ways to determine this is by checking: /etc/openwrt_release

This file exists on every OpenWrt installation and contains structured system information.

How to check it

1. Connect to your device via SSH.
2. Run: cat /etc/openwrt_release
3. Look for the line: DISTRIB_ARCH="..."

The value inside the quotes is your device’s architecture.
It must match one of the available Usteer‑NG package platforms.

Examples

DISTRIB_ARCH="mips_24kc" → Use the Usteer‑NG package for mips_24kc

DISTRIB_ARCH="aarch64_cortex-a53" → Use the Usteer‑NG package for aarch64_cortex-a53

Why this matters

OpenWrt targets (like ath79/generic or ramips/mt7621) describe the device family,
but Usteer‑NG packages are compiled for the CPU architecture.

If the architecture does not match exactly, the package cannot be installed.

Using /etc/openwrt_release ensures you always select the correct platform.

Installation

1. Download the package (IPK or APK) for the platform identified

   • Scroll down to the Artifacts section of the last successful run.
   • Download the artifact containing the built package

2. Install the APK (Alpine Linux) package on your device

   • Transfer the APK to your router (e.g., via scp).
   • Install it using:

     apk add --allow-untrusted /path/to/usteer-ng.apk