Skip to content
wrangler-deploy

Doctor

Run this when something isn’t working and you’re not sure where to start. Good first step after upgrading wrangler, onboarding a new team member, or seeing a CI failure you can’t explain.

Usage

Section titled “Usage”
Terminal window
$ wd doctor
  wrangler-deploy doctor


  ✓ wrangler installed: wrangler 4.80.0
  ✓ wrangler auth: logged in as jag.reehal@gmail.com
  ✓ worker path: workers/api exists
  ✓ worker path: workers/batch-workflow exists
  ✓ worker path: workers/event-router exists
  ✓ config valid: No config errors

When something is wrong, you’ll see it:

Terminal window
$ wd doctor
  wrangler-deploy doctor


  ✓ wrangler installed: wrangler 4.80.0
  ✗ wrangler auth: not logged in
  ✓ worker path: workers/api exists
  ✗ worker path: workers/events: no wrangler.jsonc or wrangler.json
  ✗ config valid: 2 errors
    Resource "dlq" has deadLetterFor referencing "cache-kv" which is type "kv", not a queue
    serviceBindings has unknown target worker "workers/missing"

What it checks

Section titled “What it checks”
CheckWhat it verifies
wrangler versionwrangler is installed and reachable
wrangler authwrangler whoami succeeds (catches expired tokens)
worker pathseach declared worker has a wrangler.jsonc or wrangler.json on disk
config validationwrangler-deploy.config.ts has no errors — dead-letter refs, unknown workers, invalid bindings