# r2-list home

Serverless dashboard for Cloudflare R2 storage

Canonical URL: https://kb.byaditya.com/entry/docs/dev/r2-list/readme
Source: https://docs.adityabaindur.com/docs/dev/r2-list/readme
Source updated: 2026-07-18T01:34:51Z
Indexed: 2026-11-05T03:58:26.143Z

---

[CDN Admin Logo](https://cdn.adityabaindur.dev/adityabaindur.dev/brands/r2-list/cdn/cdn-logo-p.png)

# [CDN Admin](https://adityabaindur.dev/r2)

[Image](https://img.shields.io/badge/Cloudflare%20Edge%20Platform-000000?logo=cloudflare&logoColor=F38020)
[Image](https://img.shields.io/badge/Workers%20Runtime-000000?logo=cloudflare&logoColor=F38020)
[Image](https://img.shields.io/badge/R2%20Object%20Storage-000000?logo=cloudflare&logoColor=F38020)
[Image](https://img.shields.io/badge/D1%20Database-000000?logo=cloudflare&logoColor=F38020)
[Image](https://img.shields.io/badge/Zero%20Trust%20Access-000000?logo=cloudflare&logoColor=F38020)
[Image](https://img.shields.io/badge/Serverless%20Dashboard-000000?logo=cloudflare&logoColor=F38020)
[Image](https://img.shields.io/badge/Formatted%20with%20Prettier-000000?logo=prettier&logoColor=white)
[Image](https://img.shields.io/badge/License%20MIT-000000?logo=opensourceinitiative&logoColor=white)

[Image](https://deploy.workers.cloudflare.com/?url=https://github.com/Aditya-Baindur/r2-list.git)

---

## Why CDN Admin?

[Demo video](https://github.com/user-attachments/assets/3b29f0ae-2ae1-41df-8f21-27e9e2f67ccd)

[Visit the landing page →](https://adityabaindur.dev/r2)

Cloudflare R2 is powerful, but day-to-day operations often require more than the CLI:

- Visual browsing of buckets & folders
- Fast file inspection and copyable URLs
- Object organization without leaving the browser
- Optional Cloudflare Access protection
- Telemetry via D1 for usage and observability

**CDN Admin** is a production-style dashboard you can deploy in under 2 minutes.

---

## Features

- Hierarchical folder & file browser (R2 native listing)
- Rename, move, delete, and organize objects with instant edge execution
- One-click public URL copy with clipboard integration
- D1-backed telemetry (downloads, size, activity)
- Optional Cloudflare Access protection
- Zero backend — runs entirely on Workers + R2 + D1 at the edge

---

## Architecture

- **Frontend**: Static HTML + Tailwind + Lucide icons (served from R2)
- **Backend**: Cloudflare Worker API (no traditional server)
- **Storage**: Cloudflare R2
- **Telemetry**: Cloudflare D1
- **Security (optional)**: Cloudflare Access

[cdn admin architecture](https://adityabaindur.dev/r2)

---

## Quick Deploy (Recommended)

[Image](https://deploy.workers.cloudflare.com/?url=https://github.com/Aditya-Baindur/r2-list.git)

Creates:

This deploy flow automatically provisions:

- R2 bucket (or connect an existing one)
- D1 telemetry database
- Worker bindings
- Production deployment on Cloudflare Workers

> Requires an active **Cloudflare R2 subscription**.

Developer tools for local development can be accessed at
[docs/DevTools.md](/entry/docs/dev/r2-list/docs/DevTools)

---

## Environment Variables

| Variable    | Purpose                                                 |
| ----------- | ------------------------------------------------------- |
| AUTH_STATUS | `dev` disables Access auth checks (prod enables access) |

Default:

```bash
AUTH_STATUS=dev
```