Could not finalize upload on storage server
The upload reached the storage server step, then finalize/cleanup failed. The member does not get a healthy active file.
Why this happens
After parts are ready, the app writes the object to the assigned storage backend and removes the local work directory. If cleanup fails after a write, the code rolls back when it can and throws Could not finalize upload on storage server. Common causes: storage node unreachable, disk full on the node, permission errors, or object-store errors mid-finalize.
Diagnose and fix
1. Admin → Servers — is the target server On, healthy, and not read-only / over disk cap?
2. Health Center and storage node logs (second VPS: journalctl -u xfileultra-storage when you use a remote node).
3. Disk on that server: df -h on the storage path.
4. For CDN / S3 backends: credentials, bucket permissions, and endpoint URL.
5. Ask the member to retry; if the pending file stuck, they may need to start a new upload after you fix the node.