Environment Variables

Unsterwerx recognizes the following environment variables.

Configuration

Variable	Description	Default
`UNSTERWERX_DATA`	Data directory path (database, CAS, config)	`~/.unsterwerx`
`UNSTERWERX_CANONICAL_THREADS`	Number of parallel canonical extraction workers	8

UNSTERWERX_DATA

Sets the data directory used for the SQLite database, CAS storage, and configuration files. Equivalent to --data-dir.

bash

export UNSTERWERX_DATA=/mnt/data/unsterwerx
unsterwerx status

The --data-dir CLI flag takes precedence over this variable.

UNSTERWERX_CANONICAL_THREADS

Controls the number of parallel workers used during canonical extraction (the NAC pipeline). Higher values increase throughput on multi-core systems but also increase memory usage.

bash

export UNSTERWERX_CANONICAL_THREADS=4
unsterwerx similarity

Set to 1 to disable parallel extraction (useful for debugging).

Precedence

CLI flags (--data-dir, --config)
Environment variables (UNSTERWERX_DATA)
Config file values
Built-in defaults