Getting Started

System Requirements

Requirements

Make sure your system meets these minimum requirements before installing R2Client.

Operating System: Windows 10/11, macOS, Linux
Network: Stable internet connection
Disk Space: At least 200MB available space

Installation Guide

Important Notice

As an independent developer, R2Client is not code-signed. You may see security warnings during installation. The application is completely safe to use.

Download and Install

Visit the R2Client Download Page
Download the installer for your operating system
Follow the platform-specific instructions below

macOS Installation

If you see the message "R2Client is damaged and can't be opened":

Download and Install

Download the R2Client.dmg file and drag the app to your Applications folder.

Remove Quarantine Attribute

Open Terminal and run the following command:

xattr -cr /Applications/R2Client.app

What does this command do?

This command removes the quarantine attribute that macOS adds to apps downloaded from the internet. It's safe and won't harm your system.

Launch the App

Now you can open R2Client from your Applications folder.

Windows Installation

If you see a Windows SmartScreen warning:

Run the Installer

Download the R2Client-Setup.exe file and run it.

Bypass SmartScreen

If you see "Windows protected your PC" warning:

Click "More info"
Click the "Run anyway" button

Why this warning?

This warning appears because the app is not code-signed with a Windows certificate. The software is safe and doesn't contain any malware.

Complete Installation

Follow the installation wizard and launch R2Client.

Linux Installation

Download the appropriate package for your distribution (.AppImage, .deb, or .rpm)

For AppImage:

chmod +x R2Client.AppImage
./R2Client.AppImage

For .deb (Ubuntu/Debian):
```
sudo dpkg -i R2Client.deb
```
For .rpm (Fedora/RHEL):
```
sudo rpm -i R2Client.rpm
```

First Time Setup

Launch the Application

Download and install R2Client
R2Client Download Link

Add a Bucket

Click the "+" button next to "Bucket List" on the left
Go to Settings > Bucket Management
Click the green "Add Bucket" button
Fill in the following information:
- Bucket Name: Your bucket name
- Access Key ID: Obtained from Cloudflare R2
- Secret Access Key: Obtained from Cloudflare R2
- Region: auto (or specify region)
- Endpoint: R2 API endpoint
Save configuration

Where to get credentials?

You can obtain your Access Key ID and Secret Access Key from the Cloudflare R2 dashboard.

Start Using

Select the added bucket
Start uploading and managing files

Next Steps

Once you've completed the initial setup, you can:

Learn about the interface - Understand the main interface layout
Upload your first files - Explore different upload methods
Configure settings - Customize R2Client to your needs

Need help?

If you encounter any issues during setup, check out our FAQ or Technical Support pages.

Table of Contents