diff --git a/deployment/README.md b/deployment/README.md
index 0896d09d..a1501947 100644
--- a/deployment/README.md
+++ b/deployment/README.md
@@ -123,6 +123,7 @@ Repo → Settings → Actions → Secrets — set all of:
 | `GITLAB_PAT`, `GITLAB_PROJECT_ID` | GitLab MR API |
 | `JENKINS_USER`, `JENKINS_API_TOKEN`, `JENKINS_TRIGGER_TOKEN` | Jenkins API |
 | `TELEGRAM_BOT_TOKEN`, `TELEGRAM_CHAT_ID` | Notifications |
+| `GITHUB_TOKEN` | Auto-provided by Gitea Actions — no manual setup required |
 
 ## Verifying failure paths
 
diff --git a/scripts/ci/jenkins-trigger-and-wait.sh b/scripts/ci/jenkins-trigger-and-wait.sh
index 18aa32a1..2a094e92 100755
--- a/scripts/ci/jenkins-trigger-and-wait.sh
+++ b/scripts/ci/jenkins-trigger-and-wait.sh
@@ -117,7 +117,7 @@ while :; do
   fi
   now=$(date +%s)
   if [ $((now - START)) -ge "$TIMEOUT" ]; then
-    echo "fatal: build timeout after ${TIMEOUT}s" >&2
+    echo "fatal: build timeout after ${TIMEOUT}s — see ${BUILD_URL}console" >&2
     exit 1
   fi
   sleep "$POLL_INTERVAL"