Installing with S3MultipleBuckets subsystem - Installing with S3MultipleBuckets subsystem - Alfresco - Alfresco Content Connector for AWS S3 - Alfresco/Alfresco-Content-Connector-for-AWS-S3/6.1/Alfresco-Content-Connector-for-AWS-S3/Install/Installing-with-S3MultipleBuckets-subsystem - 6.1 - 6.1

Alfresco Content Connector for AWS S3
Platform
Alfresco
Product
Alfresco Content Connector for AWS S3
Release
6.1
License
ft:lastPublication
2026-01-23T13:23:45.694000
ft:locale
en-US

These steps describe how to install the S3 Connector to an instance of Alfresco Content Services, and how to enable the S3MultipleBuckets subsystem sample.

The S3 Connector is packaged as an Alfresco Module Package (AMP) file.

You can download the release files from Hyland Community. Log in, select the Support tab, and then the Alfresco Downloads option under Software Downloads. Search for the required product version and navigate to the version page.

Note: Ensure that you don’t start Alfresco Content Services before installing the S3 Connector AMP.
  1. Download the alfresco-s3-connector-x.x.x.amp file, where x.x.x is the required product version.
  2. Use the Module Management Tool (MMT) to install the AMP into the repository WAR (alfresco.war).
  3. Unzip the alfresco-s3-connector-x.x.x.amp file.
  4. Copy the three sample files and rename them by removing the .sample extension.

    The sample files are located under:

    alfresco-s3-connector-x.x.x.amp/config/alfresco/extension/...

    They need to be copied to the relevant paths under the following folder:

    $CATALINA_HOME/shared/classes/alfresco/extension/...
    1. Copy and rename s3-multiple-buckets-context.xml.sample to: 
      s3-multiple-buckets-context.xml
    2. Copy and rename subsystems/ContentStore/S3MultipleBuckets/S3MultipleBuckets/s3-mb-contentstore-context.xml.sample to: 
      subsystems/ContentStore/S3MultipleBuckets/S3MultipleBuckets/s3-mb-contentstore-context.xml
    3. Copy and rename subsystems/ContentStore/S3MultipleBuckets/S3MultipleBuckets/s3-mb-contentstore.properties.sample to: 
      subsystems/ContentStore/S3MultipleBuckets/S3MultipleBuckets/s3-mb-contentstore.properties
  5. Check that the configuration is set up correctly for your environment:
    1. Check the S3 Connector properties for store 1 (for example, connector.s3.* or s3.*). See s3-mb-contentstore.properties for the complete list.

      The minimum properties required are:

      -Dconnector.s3.accessKey=${AWS_ACCESS_KEY_ID}
-Dconnector.s3.secretKey=${AWS_SECRET_ACCESS_KEY}
-Dconnector.s3.bucketName=${S3_BUCKET_NAME}
-Dconnector.s3.bucketRegion=${S3_BUCKET_REGION}
    2. Check the S3 Connector properties for store 2 (for example, connector.s3.store2.* or s3.store2.*). See s3-mb-contentstore.properties for the complete list.

      The minimum properties required are:

      -Dconnector.s3.store2.bucketName=${S3_BUCKET2_NAME}
-Dconnector.s3.store2.bucketRegion=${S3_BUCKET_REGION}
    3. Set S3 multiple buckets as the default file content store subsystem: filecontentstore.subsystem.name=S3MultipleBuckets
  6. Check that any other configuration is set up correctly for your environment and specifically check the multiple bucket config.
  7. Start Alfresco Content Services.