Getting started

Set up Edge Storage and upload your first object in under 5 minutes.

On this page8 sections

Prerequisites#

An Edge account (sign up free)
AWS CLI installed (optional, but recommended)

1. Create an access key#

Navigate to Storage → Access Keys in your Edge account and click Generate New Key.

2. Configure the AWS CLI#

Create a named profile for Edge Storage:

Terminal

aws configure --profile edge

Enter your key details at the prompts:

Text

AWS Access Key ID [None]: YOUR_ACCESS_KEY
AWS Secret Access Key [None]: YOUR_SECRET_KEY
Default region name [None]: us-east-1
Default output format [None]: json

3. Create a bucket#

Create your first bucket via the CLI or the console:

Terminal

aws --profile edge --endpoint-url https://storage.edge.network \
    s3 mb s3://my-first-bucket

Text

make_bucket: my-first-bucket

4. Upload your first object#

Upload a file to your new bucket:

Terminal

echo "Hello, Edge Storage!" > hello.txt

aws --profile edge --endpoint-url https://storage.edge.network \
    s3 cp hello.txt s3://my-first-bucket/

Text

upload: ./hello.txt to s3://my-first-bucket/hello.txt

5. Verify the upload#

List objects in your bucket:

Terminal

aws --profile edge --endpoint-url https://storage.edge.network \
    s3 ls s3://my-first-bucket/

Text

2025-02-12 10:30:00         21 hello.txt

Tip: create an alias#

Add this to your ~/.bashrc or ~/.zshrc:

Terminal

alias es='aws --profile edge --endpoint-url https://storage.edge.network s3'

Then use it like this:

Terminal

es ls
es cp file.txt s3://my-bucket/
es sync ./local-dir s3://my-bucket/backup/

Next steps

Something unclear or out of date? Tell us

View as Markdown Get support