Building your own package

Actually, the latest OpenWrt release and snapshot are built automatically every week.

If you want to build the latest usteer-ng release for the OpenWrt version you are currently using, you can simply fork this repository and run the Publish GitHub Action with an OpenWrt version override (for example: 24.10-SNAPSHOT) to create an IPK instead of the default APK.

Step-by-step: Running the “Publish” GitHub Action

1. Fork the repository

   • Open the NilsRo/usteer-ng repository on GitHub.
   • Click Fork in the top-right corner to create your own copy.

2. Enable GitHub Actions

   • In your fork, go to the Actions tab.
   • If Actions are not yet enabled, confirm the activation prompt.

3. Select the “Publish” workflow

   • In the left sidebar, click on Publish.
   • You will see the workflow description and previous runs.

4. Start a manual workflow run

   • Click Run workflow.
   • A dialog with input fields will appear.

5. Set the OpenWrt version override

   • Enter the desired OpenWrt version in the OpenWrt version override field, for example:
     • 24.10-SNAPSHOT
   • Leave all other fields unchanged unless you need to modify them.

6. Trigger the workflow

   • Click Run workflow again to start the build.
   • GitHub will queue and execute the job.

7. Monitor the build progress

   • A new run will appear in the list within a few seconds.
   • Click the run to view logs and status updates.
   • Wait until the run completes with a green Success badge.

8. Download the generated package (IPK or APK)

   • Scroll down to the Artifacts section of the successful run.
   • Download the artifact containing the built package:
     • IPK → for OpenWrt builds
     • APK → for Alpine Linux builds (default when no OpenWrt override is set)

9. Install the package on your device

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

       opkg install /path/to/usteer-ng.ipk

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

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