Amazon S3

You can integrate your existing Amazon S3 Storage to imagemash.io. You don't need to fully migrate to IM Cloud Storage. Imagemash can connect to your existing storage to deliver files at your service.

This guide will walk you through how to connect Amazon S3 Storage to imagemash.io.

Step 1: Acquiring your access key

We need to acquire an access Key for your storage. If you have a key, you can skip to the next steps.

1. Go to Amazon Console and navigate to Amazon IAM (Identity and Access Management) https://console.aws.amazon.com/iam

2. Navigate to Users from the menu on the left-side

3. Click Add Users. Enter a username (Eg. imagemash-user) and click next to go Set Permissions section.

4. Choose "Attach Policies Directly". Search for "AmazonS3ReadOnlyAccess", click the checkbox and proceed to the Review section and click Create User.

5. Navigate to that user in the Users section. Click on Security Credentials. Find "Access keys" section and click "Create access key".

6. Choose any of the available options. It does not matter which one you pick. Click Next.

7. Enter a description tag to your key, so you can remember what this key does. (Eg. imagemash-user-accessKey). Click Create Key.

8. Get your Access key and Secret access key. Copy in a temporary place because you won't be able to see them again. Be careful, you can't CTRL+C secret key. You need to copy via mouse or you can download the CSV file. Click Done.

9. Now we have got your key. Proceed to the next step.

Step 2: Adding External Storage

1. Go to imagemash.io Dashboard->Sources->Amazon S3 https://imagemash.io/dashboard/sources/amazon

2. Fill in the credentials and click the Check Connection & Save button.

3. If the credentials are correct, your source will be added. You should be able to see it in the My Sources menu.

4. If it gives an error, please double-check your credentials. Feel free to contact us if you need help.

Step 3: Access your files

1. Let's assume your CDN Delivery Link is john.imagemash.io

2. Let's assume you have a file logo.png in the folder logos which exists in your external storage.

3. You can access your image from: https://john.imagemash.io/logos/logo.png

You can arrange the order of your external sources in your dashboard.

The order of your external sources matters. If you have exact same file path in your other storage which is on top of others, the image will be fetched from this storage.