WebMail Pro 8 documentation

Using Amazon or DigitalOcean S3 instead of local file storage

By default, Files module of WebMail Pro 8 stores personal files directly on the webserver, under data/files/ directory.

You can replace local storage with S3 compatible remote storage like AWS or DigitalOcean.

To activate personal S3 filestorage, you need to disable local personal files module, by setting Disabled to true in data/settings/modules/PersonalFiles.config.json configuration file.

Then set Disabled to false in data/settings/modules/S3Filestorage.config.json file. In that file, you also need to supply connection details and bucket name - you can do that via admin interface as well:

S3 Filestorage

Most of these parameters are obtained from Amazon S3 or DigitalOcean control interfaces.

In case of Amazon S3, you obtain Access key and Secret key from IAM console, as shown here. Instead of using your root account, it's strongly recommended to create an administrator user via IAM console, and upon creating such a user and adding them to Administrators group, you'll be issued with Access key and Secret key.

You will also need to specify your region ID and a hostname used. Example of the region ID used is us-east-2, you can find the complete list of regions here. For Host, specify s3.amazonaws.com value.

For DigitalOcean, you need to create a Space as described here, with a particular region selected, then you can generate Access key and Secret key there as well. Host would look like digitaloceanspaces.com.

As for bucket prefix name, that's an optional identifier you can provide yourself, it's not obtained from any of the services, but a unique prefix which will be used for buckets created.