From 9d73628ee3c66a5d08f28e4a118dbaf306ba2261 Mon Sep 17 00:00:00 2001 From: gujishh Date: Mon, 13 Apr 2026 00:55:39 +0900 Subject: [PATCH] docs(faq): add recovery steps for missing Kiwix library XML --- admin/docs/faq.md | 12 ++++++++++++ 1 file changed, 12 insertions(+) diff --git a/admin/docs/faq.md b/admin/docs/faq.md index aa8aac1..e41c611 100644 --- a/admin/docs/faq.md +++ b/admin/docs/faq.md @@ -114,6 +114,18 @@ The Maps feature requires downloaded map data. If you see a blank area: 3. Wait for downloads to complete 4. Return to Maps and refresh +### ERROR: Failed to load the XML library file '/data/kiwix-library.xml' + +This usually means the Information Library service started before its Kiwix library index was fully initialized. + +Try this recovery flow: +1. Go to **[Apps](/settings/apps)** +2. Stop **Information Library (Kiwix)** +3. Wait 10-15 seconds, then start it again +4. If the error persists, run **Force Reinstall** for Information Library from the same page + +After restart/reinstall completes, refresh the Information Library page. + ### AI responses are slow Local AI requires significant computing power. To improve speed: