You signed in with another tab or window. Reload to refresh your session.You signed out in another tab or window. Reload to refresh your session.You switched accounts on another tab or window. Reload to refresh your session.Dismiss alert
Copy file name to clipboardExpand all lines: src/content/docs/r2/examples/rclone.mdx
+20-5Lines changed: 20 additions & 5 deletions
Display the source diff
Display the rich diff
Original file line number
Diff line number
Diff line change
@@ -1,27 +1,43 @@
1
1
---
2
-
title: rclone
2
+
title: Rclone
3
3
pcx_content_type: example
4
4
---
5
5
6
-
import { Render } from"~/components";
6
+
import { Render, Steps } from"~/components";
7
7
8
8
<Renderfile="keys" />
9
9
<br />
10
10
11
+
Rclone is a command-line tool which manages files on cloud storage. You can use Rclone to upload objects to R2.
12
+
13
+
## Configure Rclone
14
+
11
15
With [`rclone`](https://rclone.org/install/) installed, you may run [`rclone config`](https://rclone.org/s3/) to configure a new S3 storage provider. You will be prompted with a series of questions for the new provider details.
12
16
13
17
:::note[Recommendation]
14
-
15
18
It is recommended that you choose a unique provider name and then rely on all default answers to the prompts.
16
19
17
20
This will create a `rclone` configuration file, which you can then modify with the preset configuration given below.
18
21
:::
19
22
20
-
:::note
23
+
<Steps>
24
+
1. Create new remote by selecting `n`.
25
+
2. Select a name for the new remote. For example, use `r2`.
26
+
3. Select the `Amazon S3 Compliant Storage Providers` storage type.
27
+
4. Select `Cloudflare R2 storage` for the provider.
28
+
5. Select whether you would like to enter AWS credentials manually, or get it from the runtime environment.
29
+
6. Enter the AWS Access Key ID.
30
+
7. Enter AWS Secret Access Key (password).
31
+
8. Select the region to connect to (optional).
32
+
9. Select the S3 API endpoint.
33
+
</Steps>
21
34
35
+
:::note
22
36
Ensure you are running `rclone` v1.59 or greater ([rclone downloads](https://beta.rclone.org/)). Versions prior to v1.59 may return `HTTP 401: Unauthorized` errors, as earlier versions of `rclone` do not strictly align to the S3 specification in all cases.
23
37
:::
24
38
39
+
### Edit an existing Rclone configuration
40
+
25
41
If you have already configured `rclone` in the past, you may run `rclone config file` to print the location of your `rclone` configuration file:
26
42
27
43
```sh
@@ -43,7 +59,6 @@ acl = private
43
59
```
44
60
45
61
:::note
46
-
47
62
If you are using a token with [Object-level permissions](/r2/api/s3/tokens/#permissions), you will need to add `no_check_bucket = true` to the configuration to avoid errors.
Copy file name to clipboardExpand all lines: src/content/docs/r2/objects/upload-objects.mdx
+3-26Lines changed: 3 additions & 26 deletions
Display the source diff
Display the rich diff
Original file line number
Diff line number
Diff line change
@@ -13,45 +13,22 @@ You can upload objects to your bucket from the Cloudflare dashboard or using the
13
13
14
14
Rclone is a command-line tool which manages files on cloud storage. You can use Rclone to upload objects to R2. To use Rclone, install it onto your machine using their official documentation - [Install Rclone](https://rclone.org/install/).
15
15
16
-
### 1. Configure Rclone by running `rclone config`
17
-
18
-
First, configure your Rclone with the following settings.
19
-
20
-
<Steps>
21
-
1. Create new remote by selecting `n`.
22
-
2. Select a name for the new remote. For example, use `r2`.
23
-
3. Select the `Amazon S3 Compliant Storage Providers` storage type.
24
-
4. Select `Cloudflare R2 storage` for the provider.
25
-
5. Select whether you would like to enter AWS credentials manually, or get it from the runtime environment.
26
-
6. Enter the AWS Access Key ID.
27
-
7. Enter AWS Secret Access Key (password).
28
-
8. Select the region to connect to (optional).
29
-
9. Select the S3 API endpoint.
30
-
</Steps>
31
-
32
-
### 2. Upload files to R2
33
-
34
-
Upload your files to R2.
16
+
Upload your files to R2 using the `rclone copy` command.
35
17
36
18
```sh
37
-
# Upload a single file.
38
-
# Specify the target bucket with this syntax: <remote name>:<bucket name>
0 commit comments