wrangler
Setup
npm i -g wrangler
Verify installation:
wrangler --version
Always use --json flag when calling commands programmatically (where supported).
Authentication
wrangler login
Check auth status:
wrangler whoami
Resources
Workers
| Command | Description |
|---|
wrangler init | Initialize a new Worker project |
wrangler dev | Start local development server |
wrangler deploy | Deploy Worker to Cloudflare |
wrangler publish | Publish Worker (alias for deploy) |
wrangler tail | Stream realtime logs from deployed Worker |
wrangler delete | Delete a deployed Worker |
Secrets
| Command | Description |
|---|
wrangler secret put SECRET_NAME | Set a secret (prompts for value) |
wrangler secret list | List all secrets |
wrangler secret delete SECRET_NAME | Delete a secret |
KV (Key-Value Storage)
| Command | Description |
|---|
wrangler kv namespace list | List all KV namespaces |
wrangler kv namespace create <name> | Create a KV namespace |
wrangler kv namespace delete --namespace-id <id> | Delete a KV namespace |
wrangler kv key put --namespace-id <id> <key> <value> | Put a key-value pair |
wrangler kv key get --namespace-id <id> <key> | Get a value by key |
wrangler kv key delete --namespace-id <id> <key> | Delete a key |
wrangler kv key list --namespace-id <id> | List all keys in a namespace |
R2 (Object Storage)
| Command | Description |
|---|
wrangler r2 bucket list | List all R2 buckets |
wrangler r2 bucket create <name> | Create an R2 bucket |
wrangler r2 bucket delete <name> | Delete an R2 bucket |
wrangler r2 object get <bucket>/<key> | Download an object |
wrangler r2 object put <bucket>/<key> --file <path> | Upload an object |
wrangler r2 object delete <bucket>/<key> | Delete an object |
D1 (SQLite Database)
| Command | Description |
|---|
wrangler d1 list | List all D1 databases |
wrangler d1 create <name> | Create a D1 database |
wrangler d1 delete <name> | Delete a D1 database |
wrangler d1 execute <name> --command "SELECT * FROM users" | Run SQL command |
wrangler d1 execute <name> --file schema.sql | Execute SQL from file |
wrangler d1 info <name> | Show database details |
Pages
| Command | Description |
|---|
wrangler pages deploy <directory> | Deploy a Pages project |
wrangler pages project list | List Pages projects |
wrangler pages project create <name> | Create a Pages project |
wrangler pages deployment list --project-name <name> | List deployments |
Global Flags
| Flag | Description |
|---|
--json | Output result as JSON |
--config <path> | Path to wrangler.toml config file |
--env <name> | Specify environment |
--compatibility-date <date> | Set compatibility date |