> ## Documentation Index
> Fetch the complete documentation index at: https://bunny.net/docs/llms.txt
> Use this file to discover all available pages before exploring further.

# Quickstart

> Create a storage zone and upload your first file in minutes

**1. Create a Storage Zone**

1. From your Bunny dashboard, go to the left-hand navigation menu
2. Click on **Storage** and then **Add Storage Zone**
3. Enter a name for your storage zone
4. Select your storage tier (Standard or Edge SSD)
5. Select your primary storage region:
   * **Standard (HDD) tier**: Choose any region (closest to your users or origin)
   * **Edge (SSD) tier**: Frankfurt (DE) only
6. Optionally enable additional replication regions for better reliability
7. Optionally enable S3 compatibility (currently in public preview)
8. Click **Add Storage Zone**

See [Storage Tiers](https://bunny.net/docs/storage/storage-tiers.md) and [Replication](https://bunny.net/docs/storage/replication.md) for help choosing options.

**2. Get your credentials**

1. Open your newly created storage zone
2. Navigate to the **Access** tab and select **API / HTTP**
3. Copy your storage zone credentials:
   * **Storage Zone Name**: Your zone identifier
   * **Password**: Your API access key (keep this secure)
   * **API Endpoint**: Regional endpoint URL

**3. Upload your first file**

Choose your preferred upload method:

> [tab] API / HTTP
>
> ```bash theme={null}
> curl -X PUT \
>   https://storage.bunnycdn.com/your-zone-name/path/to/file.jpg \
>   -H "AccessKey: your-storage-password" \
>   --upload-file /path/to/local/file.jpg
> ```

> [tab] FTP
>
> Use any FTP client with these settings:
>
> * **Host**: storage.bunnycdn.com
> * **Port**: 21
> * **Username**: Your storage zone name
> * **Password**: Your storage zone password
> * **Mode**: Passive

> [tab] S3 (rclone)
>
> > [!NOTE]
> >
> > Requires S3 compatibility to be enabled during storage zone creation.
>
> ```bash theme={null}
> # Configure rclone (one-time setup)
> rclone config create bunnycdn s3 \
>   provider=Other \
>   access_key_id=your-storage-zone-name \
>   secret_access_key=your-storage-password \
>   endpoint=https://[region]-s3.storage.bunnycdn.com
>
> # Upload a file
> rclone copy /path/to/local/file.jpg bunnycdn:your-zone-name/path/to/
> ```

> [tab] Dashboard
>
> 1. Open your storage zone
> 2. Click **Browse Files**
> 3. Click **Upload** and select your file
> 4. Your file is now uploaded

**4. Connect a Pull Zone**

To access your files via CDN, connect your storage zone to a pull zone:

1. Go to **CDN** in the left navigation menu
2. Select an existing pull zone or create a new one
3. In your pull zone settings, go to **Origin**
4. Set **Origin Type** to **Bunny Storage Zone**
5. Select your storage zone from the dropdown
6. Click **Save**

Your files are now accessible via the pull zone URL:

```text theme={null}
https://your-pull-zone.b-cdn.net/path/to/file.jpg
```

Files are automatically replicated across regions and cached globally for fast access.

**5. Learn more**

> [card] [Dashboard](https://bunny.net/docs/storage/dashboard.md)
>
> Manage files with a visual interface

> [card] [HTTP API](https://bunny.net/docs/storage/http.md)
>
> Best performance and security for programmatic uploads

> [card] [FTP Access](https://bunny.net/docs/storage/ftp.md)
>
> Use existing FTP tools and workflows

> [card] [S3-Compatible API](https://bunny.net/docs/storage/s3.md)
>
> Use familiar S3 tools, libraries, and workflows with your storage zones.


This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.