Uploads not working
Check registration, upload maintenance, plan limits, storage health, TOS, extensions, and SFTP when uploads fail.
Uploads not working
Use this when members (or you) cannot get files into My Files.
Important: normal browser/API upload requires a signed-in member. Guest “open upload” is not the default path in current builds.
1. Who is trying?
- Guests → they must register/login first (
toggle.reg_enabledfor new signups). See Register and verify email. - Signed-in free vs Premium → per-tier upload on/off, max size, daily files, disk MB (
toggle.ul2_upl_on_*and related Users & limits). Check Edit a user (profile, role, flags) for per-user overrides.
2. Site-wide blocks
- Disable uploads maintenance (
toggle.sm1). - Full site maintenance (
toggle.sm3) — non-admins cannot use the site. - Upload geo-block:
upload_disabled_countries.
3. Is the upload UI missing tabs?
- Files / desktop uploader gone → Mods desktop uploader off (
toggle.m_z). - Remote URL / Copy files gone → those mods off or the plan blocks them (
toggle.remote_url_upload_mod,toggle.copy_files_upload_mod).
4. Queue starts then fails
1. Storage full — server disk cap or user plan disk quota. Disk caps and offline servers.
2. No eligible server — backends Off, read-only, unhealthy, or remote node still awaiting install. Storage backends overview (local vs remote node vs CDN), Health Center.
3. TOS not agreed — upload init needs agreeTos: true (browser and API).
4. Banned extension / filename — ext_allowed / ext_not_allowed / banned names under Settings → Files.
5. Direct upload SSL / CORS error on remote/CDN — Performance mode needs HTTPS + CORS. CDN Performance mode.
5. SFTP uploads missing
- Tab missing → SFTP mod / tier FTP toggles (
toggle.sftp_mod+ per-tier). - Files stuck in staging → admin SFTP ingestion; revoked users; staging not writable (Test storage).
6. API uploads fail
- Member API mod off / key rotated.
- Missing
agree_tos/agreeToson first upload.