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/buckets/public-buckets.mdx
+13-15Lines changed: 13 additions & 15 deletions
Display the source diff
Display the rich diff
Original file line number
Diff line number
Diff line change
@@ -14,10 +14,9 @@ Public buckets can be set up in either one of two ways:
14
14
- Expose your bucket as a custom domain under your control.
15
15
- Expose your bucket using a Cloudflare-managed `https://r2.dev` subdomain for non-production use cases.
16
16
17
-
These options can be used independently or together, enabling custom domains does not require enabling `r2.dev` access.
17
+
These options can be used independently. Enabling custom domains does not require enabling `r2.dev` access.
18
18
19
-
To use features like WAF custom rules, caching, access controls, or bot management, you must configure your bucket behind a custom domain.
20
-
These capabilities are not available when using the `r2.dev` development url.
19
+
To use features like WAF custom rules, caching, access controls, or bot management, you must configure your bucket behind a custom domain. These capabilities are not available when using the `r2.dev` development url.
21
20
22
21
:::note
23
22
@@ -36,6 +35,7 @@ Configure your cache to use [Smart Tiered Cache](/cache/how-to/tiered-cache/#sma
36
35
:::note
37
36
38
37
By default, only certain file types are cached. To cache all files in your bucket, you must set a Cache Everything page rule.
38
+
39
39
For more information on default Cache behavior and how to customize it, refer to [Default Cache Behavior](/cache/concepts/default-cache-behavior/#default-cached-file-extensions)
40
40
41
41
:::
@@ -62,7 +62,7 @@ To specify the minimum TLS version of a custom hostname of an R2 bucket, you can
62
62
The domain being used must have been added as a [zone](/fundamentals/setup/accounts-and-zones/#zones) in the same account as the R2 bucket.
63
63
64
64
- If your domain is already managed by Cloudflare, you can proceed to Connect a bucket to a custom domain.
65
-
- If your domain is not managed by Cloudflare, you’ll need to set it up using a [partial (CNAME) setup](/dns/zone-setups/partial-setup/) to add it to your account.
65
+
- If your domain is not managed by Cloudflare, you need to set it up using a [partial (CNAME) setup](/dns/zone-setups/partial-setup/) to add it to your account.
66
66
67
67
Once the domain exists in your Cloudflare account (regardless of setup type), you can link it to your bucket.
68
68
@@ -75,6 +75,7 @@ To view the added DNS record, select **...** next to the connected domain and se
75
75
:::note
76
76
77
77
If the zone is on an Enterprise plan, make sure that you [release the zone hold](/fundamentals/setup/account/account-security/zone-holds/#release-zone-holds) before adding the custom domain.
78
+
78
79
A zone hold would prevent the custom subdomain from activating.
79
80
80
81
:::
@@ -93,29 +94,26 @@ To disable a domain:
93
94
94
95
## Remove domain
95
96
96
-
Removing a custom domain will disconnect it from your bucket and delete its configuration from the dashboard.
97
-
Your bucket will remain publicly accessible through any other enabled access method, but the domain will no longer appear in the connected domains list.
97
+
Removing a custom domain will disconnect it from your bucket and delete its configuration from the dashboard. Your bucket will remain publicly accessible through any other enabled access method, but the domain will no longer appear in the connected domains list.
98
98
99
99
To remove a domain:
100
100
101
101
1. In **R2**, select the bucket you want to modify.
102
102
2. On the bucket page, Select **Settings**, go to **Custom Domains**.
103
103
3. Next to the domain you want to disable, select **...** and **Remove domain**.
104
-
4. Select ‘Remove domain’ in the confirmation window. The CNAME record pointing to the domain will also be removed as part of this step. You can always add the domain again.
104
+
4. Select ‘Remove domain’ in the confirmation window. This step also removes the CNAME record pointing to the domain. You can always add the domain again.
105
105
106
-
## Public Development URL
106
+
## Public development URL
107
107
108
-
Expose the contents of this R2 bucket to the internet through a Cloudflare-managed r2.dev subdomain.
109
-
This endpoint is intended for non-production traffic.
108
+
Expose the contents of this R2 bucket to the internet through a Cloudflare-managed r2.dev subdomain. This endpoint is intended for non-production traffic.
110
109
111
110
:::note
112
111
113
112
Public access through `r2.dev` subdomains are rate limited and should only be used for development purposes.
114
113
115
114
To enable access management, Cache and bot management features, you must set up a custom domain when enabling public access to your bucket.
116
115
117
-
Avoid creating a CNAME record pointing to the `r2.dev` subdomain. This is an **unsupported access path**, and we cannot guarantee consistent reliability or performance.
118
-
For production use, [add your domain to Cloudflare](#add-your-domain-to-cloudflare) instead.
116
+
Avoid creating a CNAME record pointing to the `r2.dev` subdomain. This is an **unsupported access path**, and we cannot guarantee consistent reliability or performance. For production use, [add your domain to Cloudflare](#add-your-domain-to-cloudflare) instead.
119
117
:::
120
118
121
119
### Enable public development url
@@ -134,9 +132,9 @@ To verify that your bucket is publicly accessible, check that **Public URL Acces
134
132
135
133
### Disable public development url
136
134
137
-
Disabling public development URL access removes your bucket’s exposure through the `r2.dev` subdomain.
138
-
The bucket and its objects will no longer be accessible via the Public Bucket URL.
139
-
If you’ve connected other domains, the bucket will remain accessible through those.
135
+
Disabling public development URL access removes your bucket’s exposure through the `r2.dev` subdomain. The bucket and its objects will no longer be accessible via the Public Bucket URL.
136
+
137
+
If you have connected other domains, the bucket will remain accessible for those domains.
0 commit comments