Native local domains proxy failed to become healthy (pid {})

Error message

Native local domains proxy failed to become healthy (pid {}). Check logs: {}

What it means

Error "Native local domains proxy failed to become healthy (pid {}). Check logs: {}" thrown in nikivdev/code.

Source

Thrown at src/domains.rs:837

    let pid = child.id();
    for _ in 0..50 {
        if native_healthcheck().unwrap_or(false) {
            return Ok(());
        }
        thread::sleep(Duration::from_millis(100));
    }
    if cfg!(target_os = "macos") && log_contains_permission_denied(&paths.native_log)? {
        bail!(
            "Native local domains proxy failed to bind port 80 (permission denied).\n\
macOS requires privileged socket ownership for :80 in native mode.\n\
Run once:\n  sudo {}\n\
Then retry: f domains --engine native up\n\
Log: {}",
            macos_launchd_install_script_hint(),
            paths.native_log.display()
        );
    }
    bail!(
        "Native local domains proxy failed to become healthy (pid {}). Check logs: {}",
        pid,
        paths.native_log.display()
    )
}

fn native_tuning_args() -> Result<Vec<(&'static str, String)>> {
    const MAPPINGS: [(&str, &str); 8] = [
        (
            "FLOW_DOMAINS_NATIVE_MAX_ACTIVE_CLIENTS",
            "--max-active-clients",
        ),
        (
            "FLOW_DOMAINS_NATIVE_UPSTREAM_CONNECT_TIMEOUT_MS",
            "--upstream-connect-timeout-ms",
        ),
        (
            "FLOW_DOMAINS_NATIVE_UPSTREAM_IO_TIMEOUT_MS",

View on GitHub (pinned to a747e741ae)

When it happens

Trigger: Thrown at src/domains.rs:837 when the library encounters an invalid state.

Common situations: See trigger scenarios.

AI-assisted analysis of nikivdev/code@a747e741ae (2026-09-01). Data as JSON: /api/errors/3dc6a2884cff47ab. Report an issue: GitHub.