Unsupported header x-amz-checksum-algorithm received for this API call.

If object storage is configured for Gitea, you may get the following error when trying to upload attachments:

NewAttachment: Create: Unsupported header 'x-amz-checksum-algorithm' received for this API call.

This happens because some object storage services like Backblaze and Cloudflare don’t support the x-amz-checksum-algorithm header that Gitea is sending. There’s a configuration value to change Gitea to use the legacy md5 behavior that these services expect:

Gitea Documentation:

MINIO_CHECKSUM_ALGORITHM: default: Minio checksum algorithm: default (for MinIO or AWS S3) or md5 (for Cloudflare or Backblaze)

Setting MINIO_CHECKSUM_ALGORITHM in the configuration to md5 should fix the error.

History