---
title: "Getting started"
description: "Step-by-step guide to Edge Network storage: create an access key, configure the AWS CLI, then create a bucket and upload and verify your first object."
url: "https://edge.network/docs/storage/getting-started"
section: "Storage"
---

# Getting started

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

## Prerequisites

- An Edge account ([sign up free](/console))
- AWS CLI installed (optional, but recommended)

## 1. Create an access key

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

> [!WARNING]
> Save your Secret Access Key immediately. It won't be shown again.

## 2. Configure the AWS CLI

Create a named profile for Edge Storage:

```bash
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:

```bash
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:

```bash
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:

```bash
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`:

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

Then use it like this:

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

## Next steps

- [SDK examples](/docs/storage/sdk-examples) — Integrate with your application
- [Multipart uploads](/docs/storage/multipart-uploads) — Upload large files efficiently