From 61b5d93b1102512a17b66791a8fc4bfb436b0aa7 Mon Sep 17 00:00:00 2001 From: ssmithx Date: Sat, 5 Sep 2026 16:36:53 +0000 Subject: [PATCH] docs(openwrt): document the transient post-reboot apk-update failure MIME-Version: 1.0 Content-Type: text/plain; charset=UTF-8 Content-Transfer-Encoding: 8bit Observed live on archy-x250-pa3: right after WAN reconnects (fresh boot or WAN reconfigure), the first Install attempt can fail with "apk update failed ... router may have no internet access" purely because the WiFi-uplink STA association hasn't finished yet — it's not a real error, just retry a few seconds later. Also cross-referenced the now-fixed /usr/bin/opkg hardcoding bug for anyone hitting it on an older build. Co-Authored-By: Claude Sonnet 5 Claude-Session: https://claude.ai/code/session_0176RpCxFNS9ZaSJjL72W9Z5 --- docs/openwrt-gateway-setup.md | 12 ++++++++++++ 1 file changed, 12 insertions(+) diff --git a/docs/openwrt-gateway-setup.md b/docs/openwrt-gateway-setup.md index 2917e8b8..37e11ad6 100644 --- a/docs/openwrt-gateway-setup.md +++ b/docs/openwrt-gateway-setup.md @@ -198,6 +198,18 @@ new host/credentials; the newly connected router becomes the persisted one. fails**: the node sanity-checks the downloaded `.ipk` is at least 50 KB — a smaller file usually means `wget` captured an HTML error page instead (no internet access from the router, or a bad release URL). +- **Install fails right after a reboot or a fresh WAN setup** with `apk + update failed ... router may have no internet access` even though WAN + looks configured: this is usually just timing, not a real problem — the + router's WiFi-uplink association (`wwan`/`hakodosh`-style STA interface) + can take a few seconds longer to reconnect than the dashboard takes to + let you click Install. Wait ~10–15 seconds after WAN shows `sta_state: + up` and retry; it should succeed on the next attempt. +- **Install fails with `opkg not found at /usr/bin/opkg` (or similar) even + though the router clearly has `opkg`/`apk` installed**: fixed as of + 2026-09-05 — the backend used to hardcode `/usr/bin/opkg`/`/usr/bin/apk`, + which some official OpenWrt builds don't symlink into `/bin`. If you're + running an Archipelago build from before that fix, update first. ---