Files
mikrotik-olsr/docs/update-server.md
T
feedc0de 9217046b33
Check source / check (push) Successful in 12s
Build RouterOS package release / release (push) Successful in 5m14s
Publish and promote RouterOS project site / site (push) Successful in 8s
Add self-hosted RouterOS package feed and pinned updater redirect
2026-11-22 11:50:00 +01:00

3.4 KiB

RouterOS update-feed service

The project site now includes a small HTTP service for the RouterOS v7 update metadata used by the package updater. It serves the static landing page and Gitea release list, plus the plain-text update responses verified against MikroTik's public server.

Verified HTTP responses

RouterOS requests channel metadata in this form:

GET /routeros/NEWESTa7.stable?version=7.23.8

The response is plain text containing the offered version and Unix build time:

7.25.1 1793623193

The service currently maps testing to 7.23.8 for the upgrade-path experiment, long-term to 7.24.6, and stable to 7.25.1. The version query parameter is accepted and ignored, as it is by the upstream endpoint. Unknown channels return HTTP 200 with No version available in this channel, matching the updater's plain-text response handling.

After receiving a version, the RouterOS update UI requests its changelog:

GET /routeros/7.25.1/CHANGELOG

The body is the release's plain-text changelog. The three initial changelogs are stored under site/feed/changelogs/; update them alongside the channel metadata when publishing a new package version. /healthz is used by the Kubernetes probes. /api/releases returns public Gitea release metadata for the landing page.

The service also serves /routeros/<version>/packages.csv in the observed arch,name,size format and streams the matching published, signed NPK at /routeros/<version>/<package>-<version>-<arch>.npk. It selects the newest published release revision for each package/architecture. The package list and download were exercised against a public 7.25.1 Gitea release locally.

For the exact official 7.25.1 ARM and ARM64 sys2 builds, the NPK build can replace both references to upgrade.mikrotik.com with mikrotik.brunner.ninja:

python tools/routeros.py npk routeros-7.25.1-arm.npk --arch arm \
  --patch-system --update-host mikrotik.brunner.ninja \
  --keys .keys/development.json --output build/routeros-7.25.1-arm-updates.npk

The patch rejects any other sys2 digest. Both ARM and ARM64 test NPKs built, self-verified, and contained only the project host in the updater binary. The release workflow applies it to 7.25.1 builds. A live RouterOS update check/download from this patched binary remains unverified. Do not treat a version appearing in the dialog as proof that installation works. The exact package request used by RouterOS and its behavior on the small-flash hAP ac2 still need a device test before a release is advertised as a working updater.

The update dialog handles version changes for installed packages. It does not offer a removed optional package as a same-version installation. For that experiment, download the published OLSR NPK from this site into RouterOS Files and reboot, or upload the same file with Winbox Files; do not use the version check button to reinstall it.

Hosting

The service runs from service/server.py; the corresponding container and portable Helm chart live in this repository. Its public deployment target is https://mikrotik.brunner.ninja. The service has no credentials or writable data. It reads the checked-in feed/changelog files and queries the public Gitea release API for the download page.

Local checks:

python3 -m unittest service.test_server -v
podman build -f service/Dockerfile -t localhost/mikrotik-olsr-site:test .
helm lint chart/mikrotik-olsr-site