Configuration Reference

The TCP port on which the HTTP application server listens for incoming Django traffic.

Dedicated port for Kubernetes health probes (/alive, /ready, /startup) and Prometheus metrics (/metrics). Keeping probe traffic isolated prevents health checks from being starved by heavy application traffic. When omitted, defaults to port + 1.

Application execution mode. Supported values: auto, wsgi, asgi. In auto mode, Hurricane automatically detects whether ASGI_APPLICATION is set in your Django settings and runs ASGI; otherwise, it runs standard WSGI.

Number of native OS worker threads used to handle request concurrency. When omitted, defaults to the number of available CPU cores plus 4.

Number of Rust/Tokio async runtime worker threads in Granian. In ASGI mode, defaults to the number of available CPU cores (capped at 16) to allow multi-core event loop task scheduling. In WSGI mode, defaults to 1.

Reloads code automatically when Python source file changes are detected. Intended for local development.

Enables verbose debug flag. When enabled, health probe errors return detailed error strings rather than generic status codes.

Enables serving collected static files directly through the gateway using STATIC_URL and STATIC_ROOT from Django settings.

Enables serving media files directly through the gateway using MEDIA_URL and MEDIA_ROOT from Django settings.

List of directories to watch for changes during development; automatically triggers collectstatic when changes occur.

Fast-404 protection strategy. Supported values: auto, signature, prefix, or off. In auto mode, prefix matching is used when valid URL prefixes can be extracted, otherwise signature matching. Setting to off or passing --no-fast-404 disables the shield.

List of custom regex patterns or file endings to drop at the gateway before reaching Django middleware or database connections.

List of additional URL path prefixes to drop immediately at the gateway.

Sustained request rate allowed per second per client IP address (e.g. 10/s, 20.0, or off / False to disable). Can also be configured via dictionary if preferred.

Burst token capacity allowed above the sustained rate limit for short traffic bursts.

Proxy header used to extract the client IP address behind load balancers or Kubernetes Ingress controllers.

Explicit boolean switch (True or False) to toggle the rate limiter without altering rate or burst thresholds.

URL route on the probe port for Kubernetes startup checks. Returns HTTP 200 once initialization and pre-flight commands have completed.

URL route on the probe port for Kubernetes liveness checks. Verifies that the server process and thread pool are actively responding.

URL route on the probe port for Kubernetes readiness checks. Verifies database connectivity and pending request backlog.

Maximum length of the pending request queue before /ready returns HTTP 400 to temporarily shed ingress traffic.

Disables the health probe server completely.

URL route on the probe port for Prometheus metrics exposition.

Disables Prometheus metric collection and exposition.

When False (default), HTTP access logging for probe requests (/alive, /ready, /startup, /metrics) is suppressed to prevent log noise. Set to True in settings.py to log all probe requests.

Maximum number of requests after which a worker process is restarted. When None, processes run indefinitely.

Maximum memory (Resident Set Size) in megabytes before process reload. When None, no memory reload limit is enforced.

Maximum size of the request body in bytes.

Maximum size of the request buffer in bytes.

Management command to run asynchronously during pod startup before the server opens traffic.

Checks if pending database migrations were applied before starting the server.

Checks if database migrations are pending and applies them automatically prior to opening traffic.

Opens a debugger port according to the Debug Adapter Protocol (e.g. for VS Code).

The port for the debug client to attach to.

Host of the remote PyCharm debug server.

Port of the remote PyCharm debug server.

Target URL where Hurricane sends asynchronous lifecycle notifications (startup, liveness, graceful termination).

Custom version string included in webhook payloads for deployment tracking.