Skip to main content

Production rollout

Dhal should be rolled out gradually.

Phase 1: install and monitor​

npm install @rokadhq/dhal
npx dhal init
npx dhal doctor

Use global monitor mode:

{
  "mode": "monitor"
}

Phase 2: observe events​

Review:

  • rule matches;
  • would-block decisions;
  • route distribution;
  • health/preflight behavior;
  • bot false positives;
  • API client behavior.

Phase 3: create route profiles​

Create profiles for high-risk routes.

{
  "routes": {
    "/api/login": {
      "mode": "block"
    }
  }
}

Phase 4: replay false positives​

npx dhal replay fixtures.replay.json --fail-on-block

Phase 5: distributed state​

Move to Redis/Valkey for production multi-instance rate limits and signals.

Phase 6: observability​

Enable redacted telemetry and signed webhooks.

Release discipline​

During alpha, pin exact versions and upgrade intentionally.