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.