Downloads not working
Check maintenance, file visibility, storage offline, countdown, captcha, /limit, traffic, and link expiry when downloads fail.
Downloads not working
Use this when visitors cannot finish a download (or never get a working download link).
Mint path in the product: landing page → POST /api/download/grant → temporary /d/{token} link.
1. Is the whole site blocked?
- Full site maintenance (
toggle.sm3) → only signed-in site admins browse; everyone else is redirected. Settings → Maintenance. - Disable downloads (
toggle.sm2) → downloads off for the public while uploads may still work. - Site-wide anti-adblock overlay → guests with blockers never reach mint. Settings → Mods → Anti-adblock, plus per-tier toggles.
2. Can you open the file while signed in as owner/admin?
- Yes, but guests cannot → file is Private, Premium-only, password-gated, or geo-blocked.
- Per-file premium uses the file’s premium flag (new uploads can default from toggle.file_prem_only_default — that does not force every old public file behind premium).
- Geo: download_disabled_countries.
- Nobody can open it (“Temporary offline”) → storage server Off, unhealthy, trashed, or file missing.
- See Disk caps and offline servers, Health Center.
3. Landing loads, but the download link fails
1. Countdown still running (ul2_countdn_sec_* under Users & limits) — wait or lower it. Reloading often restarts the wait.
2. Download captcha failing — this is the per-tier download captcha (toggle.ul2_cap_dl_*), not the register/contact captcha keys.
3. Parallel download limit → member hits /limit when too many simultaneous /d/ streams for that tier (ul2_sim_dl_*).
4. Bandwidth / traffic exhausted → traffic package wall or Users & limits bandwidth caps.
5. Direct link expired or burned — TTL symlink_expire (minutes), max uses symlink_max_uses, IP bind link_ip_logic (exact / first3 / first2 / all). Mobile IP changes break exact binds.
4. CDN / Performance mode
- Remote/CDN Performance mode (often on by default when unset) sends bytes direct from the node. Misconfigured HTTPS/CORS breaks the flow; turning it off proxies through the main app (slower, but useful to test).
- See CDN Performance mode and remote-node download docs.
5. Still stuck?
- Latest downloads / Anti-hack center — blocked grants (geo, rate limit, path tamper).
- Design → download chrome — button hidden on purpose.
- Confirm the tier still has downloads enabled (
toggle.ul2_dnl_on_*for anon / reg / prem / prem_pro).