Home

R2-Manager-Worker Documentation

Welcome to the comprehensive documentation for R2-Manager-Worker, a modern web application for managing Cloudflare R2 buckets with enterprise-grade authentication.

📖 Documentation Pages

Getting Started

• Installation & Setup - Complete guide to deploying your own instance
• Quick Start Guide - Get up and running in minutes
• Configuration Reference - Environment variables, secrets, Wrangler configuration, and hiding buckets

Core Features

• Bucket Management - Create, rename, delete R2 buckets, and bulk delete multiple buckets
• Object Lifecycles - Automate expiration and transition to Infrequent Access storage ✨ NEW
• Local Uploads - Enable per-bucket local uploads for faster upload performance ✨ NEW
• Job History - Track bulk operations with complete audit trail and event timeline ✨ NEW
• Webhooks - Configure HTTP notifications for events with HMAC security ✨ NEW
• AI Search - Connect buckets to Cloudflare AI Search for semantic search and RAG ✨ NEW
• Cross-Bucket Search - Search for files across all buckets with advanced filtering
• Folder Management - Create, rename, copy, move, and delete folders
• File Operations - Upload, download, move, copy, and delete files
• Signed URLs & Sharing - Generate secure shareable links
• Advanced Filtering - Filter by extension, size, and date with presets

User Interface

• Light/Dark Mode - Auto-detects system preference with manual toggle (System → Light → Dark)

Development

• Development Guide - Local development setup and workflow
• API Reference - Complete API endpoint documentation
• Architecture Overview - Technical stack and file organization

Security & Authentication

• Authentication & Security - Cloudflare Access Zero Trust implementation
• JWT Validation - How JWT authentication works

Support

• Troubleshooting - Common issues and solutions
• FAQ - Frequently asked questions
• Changelog - Release history and version updates ⭐ NEW
• Roadmap - Planned features and enhancements

🎯 Why R2-Manager-Worker?

Cloudflare's dashboard lacks full-featured R2 file management capabilities. This tool provides:

• Complete Control - Self-hosted alternative with advanced file and folder operations
• Job History Tracking - Complete audit trail for all bulk operations with event timeline
• AI Search Integration - Connect to Cloudflare AI Search for natural language queries, semantic search, and RAG with support for PDF, DOCX, and 20+ file formats
• Upload Verification - MD5 checksum verification ensures data integrity
• API Rate Limiting - Tiered protection (100/30/10 requests per minute by operation type)
• Cross-Bucket Search - Find files across all buckets with advanced filtering
• Bulk Operations - Download/delete multiple buckets at once with progress tracking
• Advanced Filtering - Filter by extension, size, and date with quick presets and custom ranges
• Folder Management - Hierarchical navigation with breadcrumbs
• Enterprise SSO - GitHub authentication via Cloudflare Access Zero Trust
• Edge Performance - Deployed on Cloudflare's global network
• Modern Interface - Beautiful, responsive UI built with React 19
• Theme Support - Light/Dark mode with automatic system preference detection

⚡ Quick Links

• 🎯 Live Demo - Try R2 Bucket Manager in action
• 📰 v3.4.1 Release Article - Code Quality, Dependency Updates, Security Fixes
• GitHub Repository
• Docker Hub
• Report an Issue
• Request a Feature
• Cloudflare Workers Documentation
• Cloudflare R2 Documentation

📝 License

This project is licensed under the MIT License - see the LICENSE file for details.

---

Made with ❤️ for the Cloudflare community