Configuration Reference

RaisinDB server configuration options.

Configuration File

Location: ~/.config/raisindb/config.toml

Server Configuration

[server]
host = "0.0.0.0"
http_port = 8080
pgwire_port = 5432

Storage Configuration

[storage]
type = "rocksdb"  # or "mongodb", "postgres", "memory"
path = "/var/lib/raisindb/data"

Authentication

[auth]
mode = "password"  # or "api_key", "oidc", "none"
secret_key = "your-secret-key"
token_expiry = 3600  # seconds

OIDC Configuration

[auth.oidc]
enabled = true
provider = "google"
client_id = "your-client-id"
client_secret = "your-client-secret"
issuer_url = "https://accounts.google.com"

Tenants

[tenants.default]
enabled = true
max_repositories = 100

[tenants.production]
enabled = true
max_repositories = 50

Logging

[logging]
level = "info"  # debug, info, warn, error
format = "json"  # or "text"
output = "stdout"  # or file path

Performance

[performance]
max_connections = 1000
query_timeout = 30  # seconds
max_query_results = 10000

Vector Search Configuration

[embedding]
# Distance metrics: "cosine", "l2", "inner_product", "hamming"
distance_metric = "cosine"

# Default max distance threshold for search results
default_max_distance = 0.6

# HNSW index parameters
hnsw_m = 16                  # Bi-directional links per node
hnsw_ef_construction = 200   # Candidate list size during index building
hnsw_ef_search = 50          # Candidate list size during search

# Vector quantization: "f32", "f16", "int8"
quantization = "f32"

Locks

Enables the atomic locks & inventory subsystem. Off by default.

[locks]
enabled = true
backend = "inprocess"   # "inprocess" = single server; "redis" = cluster
reaper_interval_secs = 30

[locks.redis]           # only used when backend = "redis"
url = "redis://127.0.0.1:6379/0"
namespace = "raisin:locks"

Option	Default	Description
enabled	false	Master switch for locks and inventory.
backend	"inprocess"	"inprocess" (single node) or "redis" (cluster).
reaper_interval_secs	30	Expired-lock sweep interval (in-process backend).
redis.url	redis://127.0.0.1:6379/0	Redis connection URL.
redis.namespace	raisin:locks	Key prefix on the Redis instance.

warning

The inprocess backend does not coordinate across servers. In a multi-node cluster use backend = "redis", or locks/inventory will oversell. The redis backend requires a server built with the locks-redis feature.

Environment Variables

Override config with environment variables:

• RAISINDB_HTTP_PORT - HTTP port
• RAISINDB_PGWIRE_PORT - PostgreSQL port
• RAISINDB_STORAGE_PATH - Data directory
• RAISINDB_AUTH_MODE - Authentication mode
• RAISINDB_LOG_LEVEL - Log level