final

worker/blworker/config.py

@@ -36,6 +36,13 @@ class Settings:
     browser_path: str | None
     load_images: bool
     chrome_no_sandbox: bool
+    # Browser bring-up resilience. nodriver gives Chromium only ~2.75s to open its
+    # DevTools port before raising "Failed to connect to browser"; when many replicas
+    # cold-start at once on a CPU-bound host they blow that window. A randomized pre-launch
+    # delay de-synchronizes the herd, and a few retries cover the residual slow starts.
+    startup_jitter: float
+    browser_start_retries: int
+    browser_start_backoff: float
     # Proxy (auth-free fallback)
     proxy: str | None
     # IPRoyal residential gateway
@@ -69,6 +76,9 @@ class Settings:
             # the market APIs are pure JSON — so block images unless explicitly debugging.
             load_images=_flag("LOAD_IMAGES"),
             chrome_no_sandbox=_flag("CHROME_NO_SANDBOX"),
+            startup_jitter=_float("STARTUP_JITTER", 8.0),
+            browser_start_retries=_int("BROWSER_START_RETRIES", 4),
+            browser_start_backoff=_float("BROWSER_START_BACKOFF", 2.0),
             proxy=os.environ.get("PROXY") or None,
             iproyal_host=os.environ.get("IPROYAL_HOST", "geo.iproyal.com"),
             iproyal_port=_int("IPROYAL_PORT", 12321),