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.

Maximum concurrency ceiling and worker thread pool size used to execute Django code. When omitted, defaults to the number of available CPU cores plus 4.

Number of Rust/Tokio async runtime worker threads in Hurricane's underlying Granian engine. Defaults to detected container CPUs (capped at 4) to prevent CFS quota throttling in small pods.

Async runtime engine architecture in Granian: 'auto', 'st' (single-threaded runtime), or 'mt' (multi-threaded work-stealing runtime). In 'auto', defaults to 'st' if runtime_threads == 1 (optimal for Kubernetes pods with ≤ 1 vCPU to eliminate cross-thread synchronization overhead and avoid Linux CFS CPU quota throttling), and 'mt' when multiple runtime threads are allocated.

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 high-performance static file serving using STATIC_URL and STATIC_ROOT. When STATIC_ROOT is populated (e.g. after collectstatic), files are served natively in Rust via Granian at Nginx-grade speed (<20µs). In development or when STATIC_ROOT is empty, Hurricane automatically falls back to dynamic discovery across STATICFILES_DIRS and all installed apps without requiring collectstatic. For architecture details and workflows, see the Static & Media Files Guide.

Automatically runs Django's collectstatic command during server pre-flight startup before the network socket binds. Populates STATIC_ROOT so Granian can immediately mount assets into its native Rust streaming engine.

Enables serving user-uploaded media files directly from MEDIA_ROOT under MEDIA_URL. Mounted natively in Granian when the directory exists on disk.

List of extra directories or file paths to watch for changes during development. When combined with --autoreload, modifying any watched asset triggers Granian to reload and synchronize static bundles.

HTTP Cache-Control: max-age header duration in seconds applied to static assets served through Granian's native Rust mount. Defaults to 86400 (24 hours).

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, automatically falling back to signature matching when a root catch-all or CMS router is detected. For details on how signatures and on-demand caching operate, see the Signature Mode & Anti-Django Patterns Guide. 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. Custom patterns extend the comprehensive Built-in Signature Pattern Categories covering PHP/WordPress, Laravel, Java/Spring Actuators, ASP.NET, Node.js, and database dump probes.

List of additional URL path prefixes to drop immediately at the gateway when running in prefix mode.

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.