kdrant-core/dev.kdrant/KdrantConfig

KdrantConfig

class KdrantConfig(val host: String, val port: Int, val apiKey: String? = null, val useTls: Boolean = false, val requestTimeout: Duration = 30.seconds, val connectTimeout: Duration? = null, val socketTimeout: Duration? = null, val maxRetries: Int = 3, val retryBaseDelay: Duration = 500.milliseconds, val retryMaxDelay: Duration = 5.seconds, val dispatcher: CoroutineDispatcher = Dispatchers.IO)

Resolved, immutable connection configuration for a Kdrant client.

Constructors

KdrantConfig

constructor(host: String, port: Int, apiKey: String? = null, useTls: Boolean = false, requestTimeout: Duration = 30.seconds, connectTimeout: Duration? = null, socketTimeout: Duration? = null, maxRetries: Int = 3, retryBaseDelay: Duration = 500.milliseconds, retryMaxDelay: Duration = 5.seconds, dispatcher: CoroutineDispatcher = Dispatchers.IO)

Properties

apiKey

val apiKey: String?

API key sent as the api-key header; null disables auth.

connectTimeout

val connectTimeout: Duration?

timeout for establishing a connection; null uses the engine default.

dispatcher

val dispatcher: CoroutineDispatcher

dispatcher the client runs on; injectable for tests.

host

val host: String

Qdrant host.

maxRetries

val maxRetries: Int

how many times to retry a retryable failure (HTTP 429/502/503/504 and transient I/O errors) with exponential backoff + jitter. 0 disables retries.

port

val port: Int

Qdrant port (1..65535).

requestTimeout

val requestTimeout: Duration

per-request timeout (applies to each attempt).

retryBaseDelay

val retryBaseDelay: Duration

base delay before the first retry; each subsequent retry backs off exponentially, capped at retryMaxDelay. The server's Retry-After is honored when present.

retryMaxDelay

val retryMaxDelay: Duration

upper bound on a single retry delay.

socketTimeout

val socketTimeout: Duration?

maximum idle time between two data packets on an open connection; null uses the engine default.

useTls

val useTls: Boolean

use HTTPS instead of HTTP.

Functions

toString

open override fun toString(): String

Renders the config without exposing apiKey, so it is safe to log.