juspay/hyperswitch · error

Failed to create the server

Error message

Failed to create the server

What it means

Error "Failed to create the server" thrown in juspay/hyperswitch.

Source

Thrown at crates/drainer/src/main.rs:50

    let _guard = router_env::setup(
        &conf.log,
        router_env::service_name!(),
        [
            router_env::service_name!(),
            "actix_server",
            "open_feature",
            "superposition_provider",
            "superposition_sdk",
        ],
    );

    #[allow(clippy::expect_used)]
    let web_server = Box::pin(start_web_server(
        state.conf.as_ref().clone(),
        stores.clone(),
    ))
    .await
    .expect("Failed to create the server");

    tokio::spawn(
        async move {
            let _ = web_server.await;
            logger::error!("The health check probe stopped working!");
        }
        .in_current_span(),
    );

    logger::debug!(startup_config=?conf);
    logger::info!("Drainer started [{:?}] [{:?}]", conf.drainer, conf.log);

    start_drainer(stores.clone(), conf.drainer).await?;

    Ok(())
}

View on GitHub (pinned to 705a321950)

Solutions

1. Check that the configured listen address/port is free and valid, and review the server startup logs

When it happens

Trigger: Thrown at crates/drainer/src/main.rs:50 when the library encounters an invalid state.

Common situations: See trigger scenarios.

AI-assisted analysis of juspay/hyperswitch@705a321950 (2026-08-19). Data as JSON: /api/errors/a3deb9ce4dc81cc5. Report an issue: GitHub.