​
Overview

Regatta Storage is a cloud storage service that transforms your existing S3 buckets into an unlimited, local disk. With Regatta, applications can instantly work with massive data sets in S3 without waiting for data to download.

​
Supported Platforms

Regatta is designed to work seamlessly across major operating systems running on Amazon EC2:

Linux Instances on EC2

  • Ubuntu 20.04+
  • CentOS/RHEL 7+
  • Amazon Linux 2
  • Arch Linux (Beta Support)

macOS Instances on EC2

  • macOS (Beta Support)

Windows Instances on EC2

  • Windows (Beta Support)

​
Getting Started

To get started with Regatta:

1

Create a File System

  • Log into the Regatta Console.
  • Click Create.
  • Create a name for your file system.
  • Select the region where your EC2 instance is running.

Currently, only the us-east-1 region is supported. Please contact support@regattastorage.com if you need to use a different region.

  • Specify the S3 bucket name and optional prefix.

Bucket must already exist. Specifying a prefix is optional and will limit the scope of the file system to a subtree of the bucket.

  • For S3 compatible providers, provide an endpoint, access key ID, and secret access key. See details below.
  • Click Submit.
2

Configure Bucket Access

  • Login to your AWS S3 console
  • Browse to your specified bucket
  • Update the bucket permissions policy to allow Regatta access to the bucket. The console will provide the exact policy to add. It will look something like this:
{
    "Version": "2012-10-17", 
    "Statement": [
        {
            "Sid": "AllowRegattaAccess",
            "Effect": "Allow",
            "Principal": {
                "AWS": "arn:aws:iam::904233114299:role/regatta-s3.prod.us-east-1"
            },
            "Action": "s3:*",
            "Resource": [
                "arn:aws:s3:::YOUR-BUCKET-NAME",
                "arn:aws:s3:::YOUR-BUCKET-NAME/*"
            ],
            "Condition": {
                "StringLike": {
                    "aws:userid": "*:YOUR-FILESYSTEM-ID"
                }
            }
        }
    ]
}
3

Authorize your EC2 instance to access the file system

  • Get your EC2 instance’s IAM role arn using the following command:
aws sts get-caller-identity --query 'Arn' --output text |\
sed 's/\:sts\:/\:iam\:/' |\
sed 's/\:assumed-role\//\:role\//' |\
cut -d'/' -f1-2
  • Copy the resulting IAM role arn.
  • Return to the file system’s Details page in the Regatta console, and paste the role arn as an Authorized User.
4

Install the Client

Install the Regatta client on your EC2 instance:

curl https://s3.amazonaws.com/regatta-client/install | sh
5

Mount Your File System

Mount your file system using the provided file system ID:

sudo mount -t regatta <file-system-id> /mnt/data
6

Start Using Your Data

Your S3 data is now available as a local file system with changes automatically synchronized back to S3.

[ec2-user@ip-172-31-85-XXX ~]$ sudo mount -t regatta fs-000000000000abcd /mnt/data
Successfully started tunnel on 45103
Successfully mounted fs-000000000000abcd on /mnt/data
[ec2-user@ip-172-31-85-XXX ~]$ cd /mnt/data
[ec2-user@ip-172-31-85-XXX data]$ ls
my-data  my-bucket-txt.txt

Create Your First File System

Get started by creating a new Regatta file system

Architecture