[Bug]: large downloads sometimes stall and never complete or abort.

[markjoldham]

Issue Category

Content Downloads (ZIM, Maps, Collections)

Bug Description

Axios stream timeout only covers the initial connection, not the body. Once streaming starts, a stalled server would hang indefinitely.

Partial fix could be:
Added stallTimeout param (default 60s) to DoResumableDownloadParams
Reset a timer on every received chunk; abort if no data arrives within the window
Treat stall errors as retriable network errors in doResumableDownloadWithRetry so partial downloads can resume from where they left off

Steps to Reproduce

1. start downloading many things (I want the largest collection of everything of course).
2. watch the downloads, when it gets to a big one like the full large wikipedia, it will download for hours, starting out fast, then slowing down as it goes, until it finally stalls and stops downloading.
3. it never fails out or aborts, it just stops sucking data from the internet.

Expected Behavior

download all packages until complete
If it stops getting data for a period of time, abort the download.
if the already collected data is good, leave it in a resumable state.
If it is not in a resumable state, clean up the partial files.

Actual Behavior

Just stops downloading.

N.O.M.A.D. Version

1.29.1

Operating System

Other (not yet officially supported)

Docker Version

29.3.0

Do you have a dedicated GPU?

Not sure

GPU Model (if applicable)

No response

System Specifications

Intel Core I7 10750H CPU @ 2.6G x 12
Quadro T2000 with Max-Q Design/PCIe/SE2 / Mesa Intel UHD Graphicsd
512 G disk (mostly empty, only has Zorin installed)
16G Ram
Zorin OS 17.3 Core

Service Status (if relevant)

No response

Relevant Logs

Browser Console Errors (if UI issue)

Screenshots

No response

Additional Context

1G FiOS, internet is stable. Power saver settings turned off. Have started over several times from fresh OS install.

Made some code changes (see bug description), which got me a lot further, but I'm still having the slowdown/halt when trying to download the larger files, such as the full Wikipedia.

I downgraded from Zorin 18 to Zorin 17 at the recommendation of others on Discord.

Great product, looking forward to having it fully implemented.

Pre-submission Checklist

• I have searched for existing issues that might be related to this bug
• I am running the latest version of Project N.O.M.A.D. (or have noted my version above)
• I have redacted any personal or sensitive information from logs and screenshots
• This issue is NOT related to running N.O.M.A.D. on an unsupported/non-Debian-based OS

[as-kholin]

I saw the same thing with the large download (using Debian as the OS). Also 1Gbps internet (TDS, in my case).
It has been sitting without change for almost 24 hours. Used iftop to confirm it was not communicating with anything outside my network. Changed Wikipedia (specifically) to a smaller size, and immediately saw it start downloading at close to 90 Mbps.

[chriscrosstalk]

Good analysis. You're right that the Axios stream timeout only covers the initial connection. A stall timeout that resets on each received chunk would catch this. Keeping this open as a real bug. Two reports of the same behavior adds confidence this is a genuine issue.

[grkstyla]

yeah, my complete wikipedia install just says downloading for more than 36 hours on 200MB/sec internet, tried restarting server a couple times, but im happy to wait for a fix, there is also nothing in active downloads in bottom of the page, wish there was something where we could check the progress frozen or not :) keep up the good work.

[blip33]

+1 on the wikipedia bundle. When I checked on network bandwidth from my Ubuntu install it was < 1 Kbps. No way to restart it and won't timeout and mark it failed/incomplete.

[doremusc]

I am running into the same issue on 2 different machines. For now i've resorted to setting Wikipedia to "No Wikipedia", then using the Kiwix Library and downloading it from there. So far it looks good and shows up in the "Active Downloads" section.

[archebyte]

Many incomplete, never started, or hung downloads. I've been trying to get better error feedback but not familiar enough with errors or intended behavior thus far. Some downloads were interrupted by disconnected internet.

1. Deleting models then installing new ones either never starts, or delayed start and no more than one will queue after removing any models. Confirmation that the download started always shows, but never actually starts.
2. Information library download (full) was interrupted, never restarted despite indicator (strangely not the same downloading indicator in Content Explorer), CE indicator (blue) keeps spinning. Restarted apps many times, restarted machine, stopped containers, started containers. Now Information Library will not start, reinstall with no change. App will not run any longer.
3. Content Explorer additional content will not save setting (tier not saved in each additional content options), does not download all resources despite indicating download has started (as with models). Active downloads not showing downloads, no network activity.
4. Firefox (latest) I did not try Chrome

Happy to run a task, or execute something for you?

System Details Report

---

Report details

• Date generated: 2026-03-18 21:49:14

Hardware Information:

• Hardware Model: HP Z8 G4 Workstation
• Memory: 384.0 GiB
• Processor: 2x Intel® Xeon® Gold 6226R × 64
• Graphics: NVIDIA GeForce RTX™ 4090
• Disk Capacity: 88.0 TB

Software Information:

• Firmware Version: P60 v02.96
• OS Name: Ubuntu 24.04.4 LTS
• OS Build: (null)
• OS Type: 64-bit
• GNOME Version: 46
• Windowing System: X11
• Kernel Version: Linux 6.17.0-19-generic

[chriscrosstalk]

Jeez that's a beefy server!! @archebyte

But we have some fixes coming for the intermittent download issues in our next release - I just did the PR for it myself today. Stay tuned!

[archebyte]

Happy to test when ready! At this point I may need to wipe it all and start again as some things seem unrepairable ATM. :)

[archebyte]

@chriscrosstalk sorry I forgot to mention I had lots of issues with benchmarking too. Seemingly incorrect rank (50-60%?) and it would always error out, but did log in the output logs below.

[cosmistack-bot]

🎉 This issue has been resolved in version 1.30.0-rc.1 🎉

The release is available on GitHub release

Your semantic-release bot 📦🚀