R2 Desk ProR2 Desk PRO
Buy Private Beta$29 / R2CONTROL / first 100
Navigation
Buy Private Beta$29 / R2CONTROL / first 100Read docs
Documentation hub

Cloudflare R2 desktop client docs, quickstart, and troubleshooting.

Use these guides when you need a Cloudflare R2 GUI install path, bucket browser workflow, upload or download guidance, sync behavior, signed URL delivery details, or troubleshooting for R2 Desk Pro.

Read product overviewBuy Private Beta
Launch baseline

Start with 7 days free. Continue at $29 per license.

Every desktop build starts with 7 days of full Pro access. When the trial ends, buy a license key through Lemon Squeezy if you want to keep using the product. First 100 customers get 25% off with code R2CONTROL. The promo cap is global across all platform variants. One-time purchase only. Not a subscription. All pricing excludes local taxes.

12core docs
3desktop variants
7free trial days
  • App version from the About panel
  • Operating system and whether this is a release build or source build
  • Exact repro steps and the expected result
  • Actual result with screenshot or recording where relevant
Trial and license guide
Start here

The shortest reliable path to a working R2 Desk Pro workflow.

Follow this sequence instead of jumping between random pages. It gets a new buyer from overview to trial to a stable operating baseline with the least support debt.

01
Overview

Understand the full Private Beta product surface first

Start with the product overview for positioning, capability matrix, launch offer, store links, and the trial-to-license path.

8 minProduct overview
Open step
02
Install

Move from install to first working bucket operation

Quickstart covers install, EULA acceptance, the 7-day trial, paid licensing, vault setup, first profile validation, and the first smoke check.

6 minQuickstart
Open step
03
Platform

Use the correct Windows, macOS, or Linux install path

Platform notes cover installer types, runtime prerequisites, OS-specific warnings, and support boundaries by desktop variant.

9 minPlatform setup and environment notes
Open step
04
Licensing

Know the vault and licensing rules before the trial ends

Security, vault, and licensing explains keychain storage, EULA gating, the 7-day trial, and one activation per paid license.

8 minSecurity, vault, and licensing
Open step
Platform coverage

Desktop platform guidance is explicit about support and installer warnings.

Platform behavior is documented separately because installers, runtime prerequisites, native security warnings, and support posture are not identical across the three desktop targets.

Launch safety

Windows SmartScreen and macOS Gatekeeper warnings are documented up front so beta install friction does not turn into avoidable refunds or support escalations.

Windows

  • NSIS .exe and .msi release artifacts
  • WebView2 runtime required
  • SmartScreen unknown-publisher warning documented for beta installs
Platform notesQuickstartTroubleshooting

macOS

  • DMG release path and local build distinctions
  • Keychain prompts and native file access behavior
  • Gatekeeper unidentified-developer warning documented for unsigned beta builds
Platform notesQuickstartTroubleshooting

Linux

  • Ubuntu/Debian .deb support plus AppImage fallback
  • WebKitGTK, AppIndicator, and desktop-environment requirements
  • Non-Debian distributions treated as best-effort
Platform notesBuild and releaseTroubleshooting
By workflow

Find the guide by the job you are actually doing.

The product is not one screen. The docs are organized around real operator tasks: trial, licensing, bucket administration, transfer execution, preview and delivery, settings, security, and release engineering.

Task-based entry

Open the guide for the task in front of you instead of skimming every page and hoping the right answer is somewhere in the middle.

Workflow

Run bucket administration from one desktop workspace

Bucket create/delete, location hints, storage class, jurisdiction, domains, lifecycle, notifications, and object operations.

Open guide
Workflow

Run transfers and sync safely

Queue model, retry visibility, multipart handling, resume support, conflict preflight, dry runs, and sync history.

Open guide
Workflow

Preview assets and ship delivery changes

Inline preview, signed URLs for GET/HEAD/PUT/DELETE, public URL mapping, cache purge, cost analysis, and live metrics.

Open guide
Workflow

Tune the product for daily use

Theme, density, transfer runtime, preview thresholds, URL defaults, cost assumptions, and vault policy.

Open guide
Workflow

Understand security and licensing

Vault behavior, keychain storage, EULA acceptance, the 7-day trial, paid licensing, and update checks.

Open guide
Workflow

Build, package, and verify releases

Desktop and website commands, installer output, CI expectations, and production build discipline.

Open guide
By problem

Common install and workflow failures have dedicated entry points.

The goal is to stop vague support requests before they start. If the issue is recurring, the docs point you to the exact failure tree or operator rule.

Support reduction

A useful docs hub routes users to the right diagnostic path first. It does not ask support to sort setup drift from real defects by hand.

Windows says Unknown publisher

Use Quickstart and Troubleshooting for the SmartScreen guidance before escalating the beta installer path as a defect.

Open path

macOS says the app is from an unidentified developer

Troubleshooting documents the Gatekeeper/Open flow for unsigned DMG installs during beta.

Open path

Uploads or sync behave unpredictably

Transfers and sync covers queue states, retrying, multipart thresholds, resume behavior, and cancellation semantics.

Open path

Delivery, URLs, or metrics do not line up

Preview, URLs, cache purge, and cost analysis explains signed/public mapping, purge requirements, and live metrics context.

Open path

Getting Started

4 article(s)

8 minStart here

Product overview

Understand what R2 Desk Pro actually is, what Private Beta includes, how the launch offer works, and how the trial-to-license flow works.

WindowsmacOSLinux
SetupSecurityLicensing
  • Product framing and audience
  • Capability matrix
  • Launch offer and store links
Read documentation
6 minStart here

Quickstart

Download the app, accept the EULA, use the 7-day trial, add a profile, and complete a first bucket smoke check.

WindowsmacOSLinux
SetupProfilesBrowserTransfers
  • Installer and trial flow
  • EULA acceptance and paid-license handoff
  • First-launch vault setup
Read documentation
9 minCore workflow

Platform setup and environment notes

Release artifacts, native runtime behavior, install warnings, filesystem differences, and local build prerequisites for Windows, macOS, and Linux.

WindowsmacOSLinux
PlatformsSetupBuildTroubleshooting
  • Release installer types by platform
  • Install-warning expectations by platform
  • Native keychain and dialog behavior
Read documentation
8 minCore workflow

Profiles and connections

How profile validation works, which inputs are required, how multiple profiles are managed, and what security controls apply to connection handling.

WindowsmacOSLinux
ProfilesSecurity
  • Required and optional profile fields
  • Multiple profile behavior
  • Validation behavior
Read documentation

Operations

4 article(s)

9 minCore workflow

Bucket browser and object operations

Bucket administration, prefix navigation, search, folder semantics, metadata editing, and object actions.

WindowsmacOSLinux
BrowserPreviewURLs
  • Bucket administration controls
  • Prefix and folder behavior
  • Global search and local filters
Read documentation
10 minCore workflow

Transfers and sync

Upload, download, retry, multipart behavior, resume support, conflict preflight, and sync plan review.

WindowsmacOSLinux
TransfersSync
  • Transfer states and summaries
  • Conflict behavior and preflight
  • Multipart, concurrency, and resume behavior
Read documentation
10 minCore workflow

Preview, URLs, cache purge, and cost analysis

How asset preview works, how public and signed delivery workflows work, how cache purge is enabled, and what the cost and metrics views are actually showing.

WindowsmacOSLinux
PreviewURLsCacheCost
  • Inline preview eligibility
  • Public URL and signed URL behavior
  • Cloudflare cache purge requirements
Read documentation
9 minReference

Settings, defaults, and operator preferences

What every settings section controls, which values affect future jobs, and how to set the app up for daily use instead of first-launch defaults.

WindowsmacOSLinux
SettingsTransfersSyncPreview
  • General UI settings
  • Transfer and sync runtime defaults
  • Preview and URL behavior
Read documentation

Security

1 article(s)

8 minCore workflow

Security, vault, and licensing

Vault gating, keychain storage, passphrase behavior, EULA acceptance, the 7-day trial, paid licensing, and update checks.

WindowsmacOSLinux
SecurityLicensing
  • Vault lock model
  • Keychain credential handling
  • HTTPS enforcement
Read documentation

Release Engineering

1 article(s)

10 minReference

Build, packaging, and release workflow

Source builds, local quality gates, installer output, website build, and CI expectations.

WindowsmacOSLinux
BuildReleaseSetup
  • Local source prerequisites
  • Desktop and website build commands
  • Installer output paths
Read documentation

Support

2 article(s)

11 minCore workflow

Troubleshooting

Concrete fixes for the failure modes people hit first: profile save, install warnings, uploads, build issues, and local environment problems.

WindowsmacOSLinux
TroubleshootingSupport
  • Installer warnings on Windows and macOS
  • Profile save failures
  • Upload and download failure patterns
Read documentation
7 minReference

Support and issue reporting

The support contract for serious users: what to read first, what evidence to include, and what gets sent back.

WindowsmacOSLinux
Support
  • What to read before contacting support
  • Required evidence checklist
  • Redaction rules
Read documentation