1# Configuration
2 
3## Environment Variables
4 
5### Set Variables
6 
7| Platform | Command |
8|----------|---------|
9| Linux/macOS | `export CLOUDFLARE_API_TOKEN='token'` |
10| PowerShell | `$env:CLOUDFLARE_API_TOKEN = 'token'` |
11| Windows CMD | `set CLOUDFLARE_API_TOKEN=token` |
12 
13**Security:** Never commit tokens. Use `.env` files (gitignored) or secret managers.
14 
15### .env File Pattern
16 
17```bash
18# .env (add to .gitignore)
19CLOUDFLARE_API_TOKEN=your-token-here
20CLOUDFLARE_ACCOUNT_ID=your-account-id
21```
22 
23```typescript
24// TypeScript
25import 'dotenv/config';
26 
27const client = new Cloudflare({
28  apiToken: process.env.CLOUDFLARE_API_TOKEN,
29});
30```
31 
32```python
33# Python
34from dotenv import load_dotenv
35load_dotenv()
36 
37client = Cloudflare(api_token=os.environ["CLOUDFLARE_API_TOKEN"])
38```
39 
40## SDK Configuration
41 
42### TypeScript
43 
44```typescript
45const client = new Cloudflare({
46  apiToken: process.env.CLOUDFLARE_API_TOKEN,
47  timeout: 120000,        // 2 min (default 60s), in milliseconds
48  maxRetries: 5,          // default 2
49  baseURL: 'https://...', // proxy (rare)
50});
51 
52// Per-request overrides
53await client.zones.get(
54  { zone_id: 'zone-id' },
55  { timeout: 5000, maxRetries: 0 }
56);
57```
58 
59### Python
60 
61```python
62client = Cloudflare(
63    api_token=os.environ["CLOUDFLARE_API_TOKEN"],
64    timeout=120,         # seconds (default 60)
65    max_retries=5,       # default 2
66    base_url="https://...",  # proxy (rare)
67)
68 
69# Per-request overrides
70client.with_options(timeout=5, max_retries=0).zones.get(zone_id="zone-id")
71```
72 
73### Go
74 
75```go
76client := cloudflare.NewClient(
77    option.WithAPIToken(os.Getenv("CLOUDFLARE_API_TOKEN")),
78    option.WithMaxRetries(5),  // default 10 (higher than TS/Python)
79    option.WithRequestTimeout(2 * time.Minute),  // default 60s
80    option.WithBaseURL("https://..."),  // proxy (rare)
81)
82 
83// Per-request overrides
84client.Zones.Get(ctx, "zone-id", option.WithMaxRetries(0))
85```
86 
87## Configuration Options
88 
89| Option | TypeScript | Python | Go | Default |
90|--------|-----------|--------|-----|---------|
91| Timeout | `timeout` (ms) | `timeout` (s) | `WithRequestTimeout` | 60s |
92| Retries | `maxRetries` | `max_retries` | `WithMaxRetries` | 2 (Go: 10) |
93| Base URL | `baseURL` | `base_url` | `WithBaseURL` | api.cloudflare.com |
94 
95**Note:** Go SDK has higher default retries (10) than TypeScript/Python (2).
96 
97## Timeout Configuration
98 
99**When to increase:**
100- Large zone transfers
101- Bulk DNS operations
102- Worker script uploads
103 
104```typescript
105const client = new Cloudflare({
106  timeout: 300000, // 5 minutes
107});
108```
109 
110## Retry Configuration
111 
112**When to increase:** Rate-limit-heavy workflows, flaky network
113 
114**When to decrease:** Fast-fail requirements, user-facing requests
115 
116```typescript
117// Increase retries for batch operations
118const client = new Cloudflare({ maxRetries: 10 });
119 
120// Disable retries for fast-fail
121const fastClient = new Cloudflare({ maxRetries: 0 });
122```
123 
124## Wrangler CLI Integration
125 
126```bash
127# Configure authentication
128wrangler login
129# Or
130export CLOUDFLARE_API_TOKEN='token'
131 
132# Common commands that use API
133wrangler deploy              # Uploads worker via API
134wrangler kv:key put          # KV operations
135wrangler r2 bucket create    # R2 operations
136wrangler d1 execute          # D1 operations
137wrangler pages deploy        # Pages operations
138 
139# Get API configuration
140wrangler whoami              # Shows authenticated user
141```
142 
143### wrangler.toml
144 
145```toml
146name = "my-worker"
147main = "src/index.ts"
148compatibility_date = "2024-01-01"
149account_id = "your-account-id"
150 
151# Can also use env vars:
152# CLOUDFLARE_ACCOUNT_ID
153# CLOUDFLARE_API_TOKEN
154```
155 
156## See Also
157 
158- [api.md](./api.md) - Client initialization, authentication
159- [gotchas.md](./gotchas.md) - Rate limits, timeout errors
160- [Wrangler Reference](../wrangler/) - CLI tool details
161