How to Connect PeaSoup S3 to Drupal (S3 Module)

Follow these steps to configure Drupal to store and serve files from PeaSoup S3 using the S3 File System module. PeaSoup’s S3-compatible API allows for media offloading and performance improvements when integrated with Drupal.

Prerequisites

• PeaSoup S3 Access: Ensure you have the following details:
  • Access key
  • Secret key
  • Bucket name
  • PeaSoup S3 endpoint URL https://s3.eu-west-1.peasoup.cloud
• Drupal website with administrator access.
• S3 File System module installed and enabled in Drupal.

Steps to Connect PeaSoup S3 to Drupal

1. Install the S3 File System Module:
   • Log into your Drupal admin interface.
   • Go to Extend and search for the S3 File System module.
   • If it’s not already installed, click Install next to the module. You can also download it from Drupal’s S3FS module page.
   • After installation, go to Extend and enable the module.
2. Configure the S3 File System Module:
   • Once the module is enabled, go to Configuration > Media > S3 File System.
   • Configure the following settings to integrate PeaSoup S3:
     • Amazon S3 Bucket Name: Enter your PeaSoup S3 bucket name.
     • Access Key: Enter your PeaSoup S3 access key.
     • Secret Key: Enter your PeaSoup S3 secret key.
     • Region: Leave this blank unless PeaSoup specifies a region.
     • Custom S3 Endpoint: Enter the PeaSoup S3 endpoint https://s3.eu-west-1.peasoup.cloud
   • Click Save Configuration to apply the settings.
3. Set File Directory to Use S3:
   • After configuring PeaSoup S3, you need to tell Drupal to store files on the S3 bucket. Go to Configuration > Media > File System.
   • Set Default Download Method to S3 File System.
   • In the Public File System Path, enter the S3 bucket or folder you want to store files in (e.g., s3://your-bucket-name).
   • Click Save Configuration.
4. Test the Connection:
   • To test the setup, upload a new file via the Drupal media or file management interface.
   • After uploading, check the file URL. It should now point to PeaSoup S3, and the file should be stored in your PeaSoup bucket (e.g., https://your-bucket.s3.eu-west-1.peasoup.cloud/path-to-your-file).
5. Configure Additional Module Settings (Optional):
   • The S3 File System module provides additional settings such as:
     • Object Expiration: Set the expiration time for objects stored on PeaSoup S3.
     • Cache-Control Headers: Control caching behavior for your media files.
     • File Visibility: Define whether your files are publicly accessible or private on PeaSoup S3.
   • Adjust these settings according to your needs and click Save Configuration.
6. Move Existing Files to PeaSoup S3 (Optional):
   • If you have existing files on your Drupal site that need to be offloaded to PeaSoup S3, the S3 File System module allows you to move them in bulk.
   • Go to the module’s settings page, and look for the option to Move Local Files to S3.
   • Follow the prompts to offload your files to PeaSoup S3.

Optional: Fine-Tune File Storage

• In the S3 File System module settings, you can further fine-tune how files are stored:
  • Compression: Enable file compression before uploading to PeaSoup S3 to save space.
  • Logging: Enable logging to monitor file uploads and track any errors.
  • Security: Enable secure file upload using encryption methods supported by PeaSoup S3.

Notes

• Ensure that your Drupal server has access to PeaSoup S3 by verifying network and firewall configurations.
• PeaSoup’s S3-compatible API allows seamless integration with Drupal, enabling scalable and cost-effective cloud storage for your site’s media files.