> ## 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](/docs/storage/storage-tiers.md) and [Replication](/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:

**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
```

**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

**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/
```

**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**

> **[Dashboard](/docs/storage/dashboard.md)**
>
> Manage files with a visual interface

> **[HTTP API](/docs/storage/http.md)**
>
> Best performance and security for programmatic uploads

> **[FTP Access](/docs/storage/ftp.md)**
>
> Use existing FTP tools and workflows

> **[S3-Compatible API](/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.