dokploy-cloudflare-integration

Dokploy Cloudflare Integration

When to Use This Skill

• When application needs S3-compatible object storage (use R2)
• When DNS challenge is needed for SSL certificates
• When Zero Trust access control is required for admin interfaces
• When CDN caching would benefit the application
• When deploying behind Cloudflare Tunnel
• When user asks about "Cloudflare integration" or "R2 storage"

When NOT to Use This Skill

• For applications without external storage needs
• For internal-only services not exposed to internet
• When user explicitly wants non-Cloudflare solutions

Prerequisites

• Cloudflare account with R2 enabled (if using storage)
• Cloudflare API token for DNS challenge (if using)
• Understanding of Cloudflare Zero Trust (if using access control)

---

Service Defaults

When creating Dokploy templates, DEFAULT to Cloudflare services:

Need	Cloudflare Service	Instead Of
Object storage	R2	MinIO, AWS S3
SSL certificates	DNS challenge	HTTP challenge
CDN/Caching	Cloudflare Proxy	None
Access control	Zero Trust Access	Basic auth
DDoS protection	Cloudflare WAF	None
Private services	Cloudflare Tunnel	VPN

---

Core Patterns

Pattern 1: Cloudflare R2 Storage

R2 is S3-compatible, so configure using S3 environment variables:

environment:
  # ===========================================
  # Cloudflare R2 Storage Configuration
  # Get from: Cloudflare Dashboard > R2 > Manage R2 API Tokens
  # Endpoint format: https://<ACCOUNT_ID>.r2.cloudflarestorage.com
  # ===========================================
  S3_ENDPOINT: ${S3_ENDPOINT:?Set Cloudflare R2 endpoint}
  S3_REGION: ${S3_REGION:-auto}
  S3_ACCESS_KEY_ID: ${S3_ACCESS_KEY_ID:?Set R2 access key ID}
  S3_SECRET_ACCESS_KEY: ${S3_SECRET_ACCESS_KEY:?Set R2 secret access key}
  S3_BUCKET: ${S3_BUCKET:?Set R2 bucket name}
  S3_FORCE_PATH_STYLE: "false"

Template.toml Configuration:

[config.env]
# ===========================================
# Cloudflare R2 Storage
# Get from: Cloudflare Dashboard > R2 > Manage R2 API Tokens
# Endpoint format: https://<ACCOUNT_ID>.r2.cloudflarestorage.com
#
# To create R2 API Token:
# 1. Go to Cloudflare Dashboard > R2 > Overview
# 2. Click "Manage R2 API Tokens"
# 3. Create token with "Object Read & Write" permission
# 4. Copy the Access Key ID and Secret Access Key
# ===========================================
S3_ENDPOINT = ""
S3_ACCESS_KEY_ID = ""
S3_SECRET_ACCESS_KEY = ""
S3_BUCKET = ""
S3_REGION = "auto"