-
Notifications
You must be signed in to change notification settings - Fork 1.5k
Description
Problem
The devdocs_en_react resource in collections/kiwix-categories.json references a URL that returns 404:
https://download.kiwix.org/zim/devdocs/devdocs_en_react_2026-01.zim
This file does not exist on Kiwix's servers. The download job retries 3 times and lands in the failed state in Redis.
Impact
-
Tier status is wrong — Computing & Technology shows as "Essential" installed even though all other Standard and Comprehensive resources are present. The
getInstalledTierForCategorycheck requires all resources in a tier to be installed, so one missing resource blocks the entire chain. -
Failed job blocks re-queue — The failed job remains in Redis, and
RunDownloadJob.getByUrlfinds it on subsequent attempts, so clicking "Comprehensive" again does nothing (returns null with no user feedback). -
No UI indication — The user sees "Essential" with no explanation of why Standard/Comprehensive won't download. The failed 404 is only visible in container logs.
Steps to Reproduce
- Fresh install or clean state
- Select Computing & Technology → Comprehensive
- All resources download except
devdocs_en_react(404) - UI shows tier as "Essential" instead of "Comprehensive"
- Clicking Comprehensive again does nothing
Suggested Fix
- Remove or replace
devdocs_en_reactinkiwix-categories.json— this file doesn't exist on Kiwix - Related to Curated collection URLs can become stale and break downloads #127 — the graceful error handling doesn't prevent the failed job from blocking tier status advancement
Environment
- Project N.O.M.A.D. v1.29.1
- Ubuntu Server 24.04.2 LTS