---
title: "Getting Started with Storage"
description: "Set up Edge Storage and upload your first object in minutes."
url: https://edge.network/docs/storage/getting-started/
---

# Getting Started with Storage

Storage

# Getting Started

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

## Prerequisites

- An Edge account ([sign up free](https://account.edge.network))
- AWS CLI installed (optional, but recommended)

1

## Create an Access Key

Navigate to [Storage → Access Keys](https://account.edge.network/storage/keys) in
your Edge account and click **Generate New Key**.

Important

Save your Secret Access Key immediately — it won't be shown again.

2

## Configure AWS CLI

Create a named profile for Edge Storage:

```
$ aws configure --profile edge
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 CLI or the control panel:

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

make_bucket: my-first-bucket
```

4

## Upload Your First Object

Upload a file to your new bucket:

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

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

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

5

## Verify the Upload

List objects in your bucket:

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

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

## Pro Tip: Create an Alias

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

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

Then use it like this:

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

## Next Steps

[SDK Examples Integrate with your application](https://edge.network/docs/storage/sdk-examples) [Multipart Uploads Upload large files efficiently](https://edge.network/docs/storage/multipart-uploads)
[Back to Docs](https://edge.network/docs) [Need help?](https://edge.network/support)