From c9b69e6efb1bdb0e832c0493fdc249e16285939d Mon Sep 17 00:00:00 2001 From: Daniel Kesselberg Date: Fri, 21 Nov 2025 19:11:15 +0100 Subject: [PATCH] docs(release-notes): add hint about s3 integrity protection Signed-off-by: Daniel Kesselberg --- admin_manual/release_notes/upgrade_to_32.rst | 9 +++++++++ 1 file changed, 9 insertions(+) diff --git a/admin_manual/release_notes/upgrade_to_32.rst b/admin_manual/release_notes/upgrade_to_32.rst index d9d991e04d3..9af533edef6 100644 --- a/admin_manual/release_notes/upgrade_to_32.rst +++ b/admin_manual/release_notes/upgrade_to_32.rst @@ -32,3 +32,12 @@ Previews Starting with Nextcloud 32.0.1, the preview provider for MP3 files, which reads cover images embedded in the files, is disabled by default for performance and stability reasons. See :doc:`../configuration_files/previews_configuration` for details on how to enable or disable the preview provider. + +S3 integrity protections enabled, configuration update may be needed +-------------------------------------------------------------------- + +The AWS SDK for PHP was updated and now enables the default integrity protections for S3. If your S3 backend does not support the default integrity protection yet, you can disable it since Nextcloud 32.0.2 by adding ``'request_checksum_calculation' => 'when_required',`` and ``'response_checksum_validation' => 'when_required',`` to the object store configuration. + +If your S3 backend does not support this, you may see an error such as ``Checksum Type mismatch occurred, expected checksum Type: null, actual checksum Type: crc32`` in your logs when uploading files. + +More details about S3 integrity protection can be found at https://docs.aws.amazon.com/sdkref/latest/guide/feature-dataintegrity.html and https://github.com/aws/aws-sdk-php/discussions/3100.