---
title: Getting started guide · Cloudflare R2 docs
description: Cloudflare R2 Storage allows developers to store large amounts of unstructured data without the costly egress bandwidth fees associated with typical cloud storage services.
lastUpdated: 2025-03-13T17:52:53.000Z
source_url:
  html: https://a74404c8.preview.developers.cloudflare.com/r2/get-started/index.md
  md: https://a74404c8.preview.developers.cloudflare.com/r2/get-started/
---

Cloudflare R2 Storage allows developers to store large amounts of unstructured data without the costly egress bandwidth fees associated with typical cloud storage services.

## 1. Install and authenticate Wrangler

Note

Before you create your first bucket, you must purchase R2 from the Cloudflare dashboard.

1. [Install Wrangler](https://developers.cloudflare.com/workers/wrangler/install-and-update/) within your project using npm and Node.js or Yarn.

* npm

  ```sh
  npm install wrangler --save-dev
  ```

* yarn

  ```sh
  yarn add --dev wrangler
  ```

1. [Authenticate Wrangler](https://developers.cloudflare.com/workers/wrangler/commands/#login) to enable deployments to Cloudflare. When Wrangler automatically opens your browser to display Cloudflare's consent screen, select **Allow** to send the API Token to Wrangler.

```txt
wrangler login
```

## 2. Create a bucket

To create a new R2 bucket from the Cloudflare dashboard:

1. Log in to the [Cloudflare dashboard](https://dash.cloudflare.com) and select **R2**.
2. Select **Create bucket**.
3. Enter a name for the bucket and select **Create bucket**.

## 3. Upload your first object

1. From the **R2** page in the dashboard, locate and select your bucket.
2. Select **Upload**.
3. Choose to either drag and drop your file into the upload area or **select from computer**.

You will receive a confirmation message after a successful upload.

## Bucket access options

Cloudflare provides multiple ways for developers to access their R2 buckets:

* [Workers Runtime API](https://developers.cloudflare.com/r2/api/workers/workers-api-usage/)
* [S3 API compatibility](https://developers.cloudflare.com/r2/api/s3/api/)
* [Public buckets](https://developers.cloudflare.com/r2/buckets/public-buckets/)
