Help › Object storage

Amazon S3

Create an access key in AWS and connect a bucket.

Mountbay connects to S3 with an access key belonging to an IAM user. The safest way is a user that can only reach the buckets you want in Finder.

Create an IAM user

  1. Sign in to the AWS IAM console and open Users › Create user.
  2. Name it, for example mountbay. Don't give it console access.
  3. On Set permissions, choose Attach policies directly › Create policy, switch to JSON and paste the policy below, replacing my-bucket with your bucket's name. Save it as MountbayBucketAccess, then attach it to the user.
{
  "Version": "2012-10-17",
  "Statement": [
    {
      "Effect": "Allow",
      "Action": ["s3:ListAllMyBuckets", "s3:GetBucketLocation"],
      "Resource": "*"
    },
    {
      "Effect": "Allow",
      "Action": ["s3:ListBucket"],
      "Resource": "arn:aws:s3:::my-bucket"
    },
    {
      "Effect": "Allow",
      "Action": ["s3:GetObject", "s3:PutObject", "s3:DeleteObject"],
      "Resource": "arn:aws:s3:::my-bucket/*"
    }
  ]
}

Create the access key

  1. Open the new user, then Security credentials › Create access key.
  2. Choose Application running outside AWS and create the key.
  3. Copy the Access key ID and Secret access key. AWS only shows the secret once.

Add it to Mountbay

  1. In Mountbay, click the menu bar icon and choose Add Connection…, then pick Amazon S3.
  2. Paste the Access Key ID and Secret Access Key, and choose your bucket's Region.
  3. In Folder or bucket, enter the bucket name (or bucket/folder) to show just that in Finder.

Empty folders don't exist in S3 on their own, so Mountbay saves a small folder marker to keep new folders visible.

Still stuck? Email support@mountbay.app and mention this guide. A person replies, usually within one working day.