The server

Configuration is all CLI flags with sane defaults — nothing is required beyond --path.

Network & data

--path

Data directory (one filesystem, for snapshot hard-links).

./data/xyzdb

--port

TCP listen port.

2505

--bind

Bind address (127.0.0.1 = loopback only).

0.0.0.0

--durability

durable | batched | async.

durable

--batch-interval

Flush interval (ms) for --durability batched.

100

--storage-profile

ssd (32 KB blocks) | hdd (64 KB blocks).

ssd

--io-scheduler

ssd (passthrough) | hdd (lane-aware).

ssd

--throttle-profile

transactional | analytical | balanced | maintenance | bulk.

balanced

--wal-path

WAL location override (same filesystem).

(co-located)

Cache & auto-ghosts

--cache-size

Block cache budget (MB); ~20–25% of RAM.

256

--record-cache-size

Record cache (MB); 0 = off. Used by INCACHE.

0

--l0-batch

Override the L0 compaction batch size (advanced).

(per profile)

--block-cache-lane-admission

enabled = compaction misses don't admit to the block cache.

disabled

--auto-ghost-min-hits

Hits / 10-min window before auto-promotion.

5

--auto-ghost-min-latency-ms

Latency threshold; 1e9 disables auto-ghosts.

20

Security & embedding

--tls-cert / --tls-key

PEM cert + key together → TLS 1.3.

(none)

--auth-token

File with a bearer token; required at connect.

(none)

--embedding-service-url

Remote SEXTANT embedding service; off by default (agnostic).

(none)

--embedding-timeout-ms

Per-request timeout for the remote embedding call.

2000