Skip to content
Justin Puah edited this page Jul 13, 2026 · 1 revision

Global config for curl — applied to every curl invocation.

Files

File Installed as
curlrc ~/.curlrc

Settings

Setting Effect
-L Follow redirects
referer = ";auto" Automatically set the previous URL as referer on redirect
connect-timeout = 30 Abort if the connection phase takes more than 30 seconds
max-time = 300 Abort if the entire request takes more than 5 minutes
compressed Request compressed response and auto-decompress
http2 Use HTTP/2 where supported (falls back to HTTP/1.1)
progress-bar Simple # progress bar instead of verbose transfer stats
retry = 3 Retry up to 3 times on transient errors (408, 429, 5xx)
retry-delay = 2 Wait 2 seconds between retries
retry-max-time = 60 Give up retrying after 60 seconds total

What was removed

Flag Why removed
-k Disabled SSL certificate verification globally — a security risk for all curl calls, including those made by scripts and tools internally
-v Verbose output on every request — breaks scripts that parse curl output and floods the terminal
user-agent = "MSIE 9.0..." IE9 spoofing causes sites to return degraded or blocked responses; also hides curl's identity which breaks APIs that expect it

Pass -k or -v explicitly on the command line when you actually need them.

Install

./setup.ps1 -Module curl   # Windows
./setup.sh  -m curl        # Linux / WSL

Source: curl/README.md in the dotfiles repo.

dotfiles wiki

Getting started

Core (Windows)

Cross-platform

Claude Code & AI

Reference

Legacy (Linux)

Troubleshooting

Clone this wiki locally