Errors

Could not finalize upload

Multipart parts could not be merged into the final file on complete (disk/IO failure).

Could not finalize upload

The browser finished sending chunks, but the server could not merge them into the final file when completing the upload.

Why this happens

On POST /api/upload/complete (and the member API complete route), the app merges multipart parts into one blob. If merge fails (disk full, permissions, missing part files, IO error), the pending file is marked failed and the member sees Could not finalize upload.

This is a server-side finalize problem, not “wrong password” or “plan blocked.”

Diagnose and fix

1. Disk space on the main app host (and the upload work directory): df -h.

2. Confirm multipart temp parts still exist for that upload; if the work dir was cleaned mid-upload, finalize will fail — ask the member to re-upload.

3. Check journalctl -u xfileultra -n 80 (or your service name) around the complete request.

4. File permissions on the upload/work paths used by the app user.

5. If only remote/CDN direct uploads fail, also check that node’s disk and connectivity (Servers & storage).

Related