Interface BunqueueConfig

Global bunqueue configuration (all sections optional)

interface BunqueueConfig {
    auth?: { requireAuthForMetrics?: boolean; tokens?: string[] };
    backup?: {
        accessKeyId?: string;
        bucket?: string;
        enabled?: boolean;
        endpoint?: string;
        interval?: number;
        prefix?: string;
        region?: string;
        retention?: number;
        secretAccessKey?: string;
        sessionToken?: string;
        virtualHostedStyle?: boolean;
    };
    cloud?: { apiKey?: string; instanceId?: string; url?: string };
    cors?: { origins?: string[] };
    logging?: {
        format?: "text" | "json";
        level?: "info" | "warn" | "error" | "debug";
    };
    server?: {
        host?: string;
        httpPort?: number;
        httpSocketPath?: string;
        tcpPort?: number;
        tcpSocketPath?: string;
        tlsCertFile?: string;
        tlsKeyFile?: string;
    };
    storage?: {
        brokerId?: string;
        completedRetentionMs?: number
        | null;
        dataPath?: string;
        driver?: "memory" | "sqlite" | "postgres";
        idleTransactionTimeoutMs?: number;
        leaseDurationMs?: number;
        lockTimeoutMs?: number;
        maxCompletedJobs?: number;
        maxConcurrentOperations?: number;
        maxQueuedOperations?: number;
        maxSnapshotJobs?: number;
        maxSnapshotPayloadBytes?: number;
        namespace?: string;
        pollIntervalMs?: number;
        poolSize?: number;
        statementTimeoutMs?: number;
        url?: string;
    };
    telemetry?: { maxPrometheusQueues?: number };
    timeouts?: {
        lock?: number;
        shutdown?: number;
        stats?: number;
        worker?: number;
    };
    webhooks?: { maxRetries?: number; retryDelay?: number };
}

Index

Properties

auth? backup? cloud? cors? logging? server? storage? telemetry? timeouts? webhooks?

Properties

`Optional`auth

auth?: { requireAuthForMetrics?: boolean; tokens?: string[] }

`Optional`backup

backup?: {
    accessKeyId?: string;
    bucket?: string;
    enabled?: boolean;
    endpoint?: string;
    interval?: number;
    prefix?: string;
    region?: string;
    retention?: number;
    secretAccessKey?: string;
    sessionToken?: string;
    virtualHostedStyle?: boolean;
}

`Optional`cloud

cloud?: { apiKey?: string; instanceId?: string; url?: string }

`Optional`cors

cors?: { origins?: string[] }

`Optional`logging

logging?: {
format?: "text" | "json";
level?: "info" | "warn" | "error" | "debug";
}

`Optional`server

server?: {
    host?: string;
    httpPort?: number;
    httpSocketPath?: string;
    tcpPort?: number;
    tcpSocketPath?: string;
    tlsCertFile?: string;
    tlsKeyFile?: string;
}

Type Declaration

Optionalhost?: string
OptionalhttpPort?: number
OptionalhttpSocketPath?: string
OptionaltcpPort?: number
OptionaltcpSocketPath?: string
OptionaltlsCertFile?: string

Path to PEM certificate file — enables native TLS on TCP + HTTP (with tlsKeyFile)
OptionaltlsKeyFile?: string

Path to PEM private key file — enables native TLS on TCP + HTTP (with tlsCertFile)

`Optional`storage

storage?: {
    brokerId?: string;
    completedRetentionMs?: number | null;
    dataPath?: string;
    driver?: "memory" | "sqlite" | "postgres";
    idleTransactionTimeoutMs?: number;
    leaseDurationMs?: number;
    lockTimeoutMs?: number;
    maxCompletedJobs?: number;
    maxConcurrentOperations?: number;
    maxQueuedOperations?: number;
    maxSnapshotJobs?: number;
    maxSnapshotPayloadBytes?: number;
    namespace?: string;
    pollIntervalMs?: number;
    poolSize?: number;
    statementTimeoutMs?: number;
    url?: string;
}

Type Declaration

OptionalbrokerId?: string

Stable identifier for this broker process; generated automatically when omitted.
OptionalcompletedRetentionMs?: number | null

Automatic age-based completed-job retention in milliseconds; null disables it.
OptionaldataPath?: string
Optionaldriver?: "memory" | "sqlite" | "postgres"

Persistence backend. Inferred from url/dataPath when omitted.
OptionalidleTransactionTimeoutMs?: number
OptionalleaseDurationMs?: number
OptionallockTimeoutMs?: number
OptionalmaxCompletedJobs?: number

Hot in-memory completed-job window; this is not durable retention.
OptionalmaxConcurrentOperations?: number
OptionalmaxQueuedOperations?: number
OptionalmaxSnapshotJobs?: number
OptionalmaxSnapshotPayloadBytes?: number
Optionalnamespace?: string

Isolates independent bunqueue installations sharing one PostgreSQL database.
OptionalpollIntervalMs?: number
OptionalpoolSize?: number
OptionalstatementTimeoutMs?: number
Optionalurl?: string

PostgreSQL connection URL. Required when driver is postgres.

`Optional`telemetry

telemetry?: { maxPrometheusQueues?: number }

Type Declaration

OptionalmaxPrometheusQueues?: number

Maximum queue label values exposed to Prometheus; zero disables per-queue series.

`Optional`timeouts

timeouts?: { lock?: number; shutdown?: number; stats?: number; worker?: number }

`Optional`webhooks

webhooks?: { maxRetries?: number; retryDelay?: number }

Interface BunqueueConfig

Index

Properties

Properties

Optionalauth

Optionalbackup

Optionalcloud

Optionalcors

Optionallogging

Optionalserver

Type Declaration

Optionalhost?: string

OptionalhttpPort?: number

OptionalhttpSocketPath?: string

OptionaltcpPort?: number

OptionaltcpSocketPath?: string

OptionaltlsCertFile?: string

OptionaltlsKeyFile?: string

Optionalstorage

Type Declaration

OptionalbrokerId?: string

OptionalcompletedRetentionMs?: number | null

OptionaldataPath?: string

Optionaldriver?: "memory" | "sqlite" | "postgres"

OptionalidleTransactionTimeoutMs?: number

OptionalleaseDurationMs?: number

OptionallockTimeoutMs?: number

OptionalmaxCompletedJobs?: number

OptionalmaxConcurrentOperations?: number

OptionalmaxQueuedOperations?: number

OptionalmaxSnapshotJobs?: number

OptionalmaxSnapshotPayloadBytes?: number

Optionalnamespace?: string

OptionalpollIntervalMs?: number

OptionalpoolSize?: number

OptionalstatementTimeoutMs?: number

Optionalurl?: string

Optionaltelemetry

Type Declaration

OptionalmaxPrometheusQueues?: number

Optionaltimeouts

Optionalwebhooks

Settings

On This Page

`Optional`auth

`Optional`backup

`Optional`cloud

`Optional`cors

`Optional`logging

`Optional`server

`Optional`host?: string

`Optional`httpPort?: number

`Optional`httpSocketPath?: string

`Optional`tcpPort?: number

`Optional`tcpSocketPath?: string

`Optional`tlsCertFile?: string

`Optional`tlsKeyFile?: string

`Optional`storage

`Optional`brokerId?: string

`Optional`completedRetentionMs?: number | null

`Optional`dataPath?: string

`Optional`driver?: "memory" | "sqlite" | "postgres"

`Optional`idleTransactionTimeoutMs?: number

`Optional`leaseDurationMs?: number

`Optional`lockTimeoutMs?: number

`Optional`maxCompletedJobs?: number

`Optional`maxConcurrentOperations?: number

`Optional`maxQueuedOperations?: number

`Optional`maxSnapshotJobs?: number

`Optional`maxSnapshotPayloadBytes?: number

`Optional`namespace?: string

`Optional`pollIntervalMs?: number

`Optional`poolSize?: number

`Optional`statementTimeoutMs?: number

`Optional`url?: string

`Optional`telemetry

`Optional`maxPrometheusQueues?: number

`Optional`timeouts

`Optional`webhooks