Skip to content

Multi-node ​

Cluster mode is multiple KiriVers processes sharing one Postgres and object store.

When to use ​

Scale downloads or admin horizontally. A single-disk install can stay one process.

Configuration entry ​

Requires storage.driver=s3 and cache.driver=redis. Otherwise cluster.download is ignored. YAML: Cluster, Redis, S3. Console: Nodes.

Rules ​

cluster.downloadBehavior
s3Public object URLs, CDN-friendly
localNode proxy; check is also private, no-store

node.display_name is a label only. Heartbeat writes Postgres; nodes do not report over HTTP.

Client duties ​

Do not CDN-cache check under local-proxy. Download URLs remain SHA-256 objects.