From 26687784b7dd9deb359a4e893c141246795a6d4f Mon Sep 17 00:00:00 2001 From: Daniel Bodnar <1790726+danielbodnar@users.noreply.github.com> Date: Thu, 23 Jul 2026 02:23:24 -0500 Subject: [PATCH] docs(deploy): mark R2 attachments mount experimental; sync anchor Claude-Session: https://claude.ai/code/session_01NWpwXBqxrPZdv75ud8xszr --- deploy/cloudflare/wrangler.jsonc | 8 ++++---- docs/deploy/cloudflare.md | 6 +++++- 2 files changed, 9 insertions(+), 5 deletions(-) diff --git a/deploy/cloudflare/wrangler.jsonc b/deploy/cloudflare/wrangler.jsonc index 638714bc72..fb86712dca 100644 --- a/deploy/cloudflare/wrangler.jsonc +++ b/deploy/cloudflare/wrangler.jsonc @@ -21,12 +21,12 @@ "bindings": [{ "class_name": "Sandbox", "name": "Sandbox" }] }, "migrations": [{ "tag": "v1", "new_sqlite_classes": ["Sandbox"] }], - // Optional: durable attachment storage. Paperclip's upload directory is - // FUSE-mounted from this bucket (credential-less, via the Worker binding), - // so attachments survive container recycling. To enable: + // Optional (experimental): durable attachment storage. Paperclip's upload + // directory is FUSE-mounted from this bucket (credential-less, via the + // Worker binding), so attachments survive container recycling. To enable: // 1. npx wrangler r2 bucket create paperclip-attachments // 2. Uncomment the block below and redeploy. - // See docs/deploy/cloudflare.md#durable-attachments-via-r2-optional. + // See docs/deploy/cloudflare.md#durable-attachments-via-r2-optional-experimental. // "r2_buckets": [ // { "binding": "ARTIFACTS", "bucket_name": "paperclip-attachments" } // ], diff --git a/docs/deploy/cloudflare.md b/docs/deploy/cloudflare.md index 7b2b8f6fd0..3186eb814b 100644 --- a/docs/deploy/cloudflare.md +++ b/docs/deploy/cloudflare.md @@ -28,7 +28,11 @@ npx wrangler secret put DATABASE_URL The Worker forwards `DATABASE_URL` into the container and Paperclip uses it instead of embedded Postgres. -## Durable Attachments via R2 (Optional) +## Durable Attachments via R2 (Optional, Experimental) + +> **Experimental:** this mount path is newer than the rest of the deployment +> and has not yet been validated on a live deployment. The default (no R2 +> binding) is unaffected. Uploaded files (issue attachments, images) can survive container recycling without any Paperclip configuration: the Worker FUSE-mounts an R2 bucket at