Command line (rrangler)

Deploy and manage everything from your terminal with the wrangler-compatible rrangler CLI.

rrangler (also installed as rr) is a command line tool for RandallFlare that understands the same commands and config files as Cloudflare's wrangler. An existing Workers project usually deploys without changes.

bash

npm i -g @bigrandall/rrangler   # Node 20 or newer
rr --version
rr login --token rfp_…         # saved to ~/.rrangler.json
rr whoami
rr doctor                      # what your token is allowed to do

Create the token under API tokens. You can also pass it per command with --token or the RRANGLER_TOKEN environment variable.

A first deploy

bash

rr init hello            # --ts for TypeScript, --python for Python
cd hello
rr dev                   # run locally on :8787 with the same runtime as the edge
rr deploy                # bundle, create the app if needed, publish
rr versions list
rr rollback              # back to the previous version

jsonc

{
  "name": "my-app",
  "main": "src/index.ts",
  "compatibility_date": "2026-09-22",
  "vars": { "GREETING": "hello" },
  "kv_namespaces": [{ "binding": "CACHE", "title": "my-cache" }],
  "d1_databases": [{ "binding": "DB", "database_name": "my-db" }],
  "r2_buckets": [{ "binding": "FILES", "bucket_name": "my-files" }],
  "queues": { "producers": [{ "binding": "JOBS", "queue": "jobs" }] },
  "triggers": { "crons": ["*/5 * * * *"] },
  "assets": { "directory": "./public" },
  "env": { "staging": { "vars": { "GREETING": "hi" } } }
}

Command	Does
`rr deploy` / `rr dev`	Publish, or run locally with emulated KV, D1 and R2
`rr tail [app]`	Stream live logs
`rr secret put\|list\|delete`	Manage secrets
`rr domains add <host>`	Attach a custom domain and print the DNS records to create
`rr versions list\|deploy <n>` / `rr rollback`	See and switch versions
`rr d1 execute DB --command "…"`	Run SQL; `rr d1 migrations apply DB` applies migrations
`rr kv key put\|get\|list`	Read and write keys
`rr r2 object put\|get\|list`	Upload and download files
`rr queues send <q> '<json>'`	Produce a message
`rr workflows trigger <name> --params '<json>'`	Start a workflow run
`rr cdn …`, `rr dns …`, `rr waf …`	Website acceleration, DNS and firewall
`rr api GET /compute`	Call any API endpoint directly

Command line (rrangler)

A first deploy

The config file

Common commands

Differences from wrangler

Command line (rrangler)

Install and sign in

A first deploy

The config file

Common commands

Differences from wrangler