From c93355d0db3673786dd9e1c76d73f2b734780196 Mon Sep 17 00:00:00 2001
From: Claude <noreply@anthropic.com>
Date: Tue, 21 Jul 2026 22:16:58 +0000
Subject: [PATCH] ota: make GitHub token optional

Requests to the releases/pulls API now go out unauthenticated when no
token is configured, instead of failing outright. This works against a
public repo, just at GitHub's lower unauthenticated rate limit. The web
UI now notes that the token is optional and only raises that limit.
---
 data/index.html      |  1 +
 src/update/Updater.h | 36 ++++++++++++------------------------
 2 files changed, 13 insertions(+), 24 deletions(-)

diff --git a/data/index.html b/data/index.html
index 1987177d..5fda6449 100644
--- a/data/index.html
+++ b/data/index.html
@@ -1120,6 +1120,7 @@ <h2>Updates</h2>
     <input type="text" id="githubRepo" placeholder="variour/lightwitch">
     <label>Personal access token <small>(fine-grained, Contents: read-only)</small></label>
     <input type="password" id="githubToken" placeholder="(unchanged if empty)">
+    <div style="font-size:.78rem;color:#888;margin-top:.15rem">Optional — only needed for a higher GitHub API rate limit.</div>
     <label style="display:flex;align-items:center;gap:.5rem;cursor:pointer;margin-top:.25rem">
       <input type="checkbox" id="checkUpdateOnStartup">
       Check for updates on startup
diff --git a/src/update/Updater.h b/src/update/Updater.h
index 77a409bc..d27a8127 100644
--- a/src/update/Updater.h
+++ b/src/update/Updater.h
@@ -18,9 +18,12 @@
 
 // GitHub API-based OTA updater.
 //
-// Normally checks the latest release in the configured repo using a PAT,
-// then flashes firmware and filesystem images if a newer version is
-// available. If Config::prOtaEnabled is set and Config::prTrack names a PR
+// Checks the latest release in the configured repo, then flashes firmware
+// and filesystem images if a newer version is available. A PAT is optional
+// (Config::githubToken) — requests are sent unauthenticated if it's empty,
+// which works fine against a public repo but is subject to GitHub's lower
+// per-IP rate limit for unauthenticated API calls. If Config::prOtaEnabled
+// is set and Config::prTrack names a PR
 // (see applyPrAsync), the same check/apply flow instead follows that PR's
 // prerelease (tag "pr-<n>") so a device already running a PR build keeps
 // picking up newer pushes to that PR through the ordinary "Check"/"Install
@@ -166,19 +169,17 @@ class Updater {
     static std::atomic<bool> _triggerPending;
     static String _pendingTag;
 
-    static String _authHeader() {
-        String h = "Bearer ";
-        h += Config::get().githubToken;
-        return h;
-    }
-
-    // Opens an authenticated GET request against the GitHub API and returns the HTTP status code.
+    // Opens a GET request against the GitHub API and returns the HTTP status code.
+    // Authenticates with the configured PAT if one is set, otherwise sends the
+    // request unauthenticated (fine for a public repo, just a lower rate limit).
     // tls/http are owned by the caller and must stay alive while the response body/stream is read.
     static int _httpGet(WiFiClientSecure& tls, HTTPClient& http, const String& url,
                         const char* accept) {
         tls.setCACertBundle(CA_BUNDLE);
         http.begin(tls, url);
-        http.addHeader("Authorization", _authHeader());
+        if (strlen(Config::get().githubToken) > 0) {
+            http.addHeader("Authorization", String("Bearer ") + Config::get().githubToken);
+        }
         http.addHeader("Accept", accept);
         http.addHeader("X-GitHub-Api-Version", "2022-11-28");
         http.setFollowRedirects(HTTPC_STRICT_FOLLOW_REDIRECTS);
@@ -194,11 +195,6 @@ class Updater {
     // (see _checkForUpdate).
     static bool _fetchRelease(const String& tag, String& outTagName) {
         auto& c = Config::get();
-        if (strlen(c.githubToken) == 0) {
-            _status.error = "no GitHub token configured";
-            return false;
-        }
-
         String url = "https://api.github.com/repos/";
         url += c.githubRepo;
         url += tag.isEmpty() ? "/releases/latest" : ("/releases/tags/" + tag);
@@ -616,14 +612,6 @@ class Updater {
     // release this repo has ever published (whose bodies/assets can add up
     // to more JSON than the device can reliably buffer and parse).
     static void _listPrBuildsTask(void*) {
-        auto& c = Config::get();
-        if (strlen(c.githubToken) == 0) {
-            _prListStatus.error = "no GitHub token configured";
-            _prListStatus.state = PrListState::Error;
-            vTaskDelete(nullptr);
-            return;
-        }
-
         std::vector<int> prNumbers;
         if (!_fetchOpenPrNumbers(prNumbers)) {
             _prListStatus.state = PrListState::Error;