Upload Failures

File too large

Attachments have a maximum file size of 5MB per file. If you need to upload larger files, consider compressing them first or splitting archives into smaller parts.

Images uploaded through the rich text editor also have size limits. If a screenshot is too large, resize it before uploading or use a tool like pngquant or jpegoptim to reduce the file size.

Upload succeeds but file appears corrupted

If a file uploads without error but appears corrupted when downloaded, check your reverse proxy configuration. Some proxies have a client_max_body_size limit that silently truncates large uploads. In Nginx, set:

client_max_body_size 10m;

Drag and drop not working

If drag and drop does not trigger the upload in the editor or attachments tab:

• Try using the file picker (click the upload area) instead
• Check that JavaScript is not blocked by a browser extension
• Some browser security settings prevent drag and drop from working in iframes