CONFIGURATION.md
Sonic looks for its configuration as TOML in ./config.cfg, or whatever you
passed via --config/-c.
This file is optional, as all configuration keys can be defined using
SONIC_ environment variables (which take precedence over the static
configuration). The path separator is __, which means foo.bar.baz will be
read from SONIC_FOO__BAR__BAZ.
All available configuration options are commented below, with allowed values:
Under [server]:
log_level (type: string, allowed: debug, info, warn, error, default: error) — Verbosity of logging, set it to error in productionUnder [channel]:
inet (type: string, allowed: IPv4 / IPv6 + port, default: [::1]:1491) — Host and TCP port Sonic Channel should listen ontcp_timeout (type: integer, allowed: seconds, default: 300) — Timeout of idle/dead client connections to Sonic Channelauth_password (type: string, allowed: password values, default: none) — Authentication password required to connect to the channel (optional but recommended)Under [channel.search]:
query_limit_default (type: integer, allowed: numbers, default: 10) — Default search results limit for a query command (if the LIMIT command modifier is not used when issuing a QUERY command)query_limit_maximum (type: integer, allowed: numbers, default: 100) — Maximum search results limit for a query command (if the LIMIT command modifier is being used when issuing a QUERY command)query_alternates_try (type: integer, allowed: numbers, default: 4) — Number of alternate words that look like query word to try if there are not enough query results (if zero, no alternate will be tried; if too high there may be a noticeable performance penalty)suggest_limit_default (type: integer, allowed: numbers, default: 5) — Default suggested words limit for a suggest command (if the LIMIT command modifier is not used when issuing a SUGGEST command)suggest_limit_maximum (type: integer, allowed: numbers, default: 20) — Maximum suggested words limit for a suggest command (if the LIMIT command modifier is being used when issuing a SUGGEST command)list_limit_default (type: integer, allowed: numbers, default: 100) — Default listed words limit for a list command (if the LIMIT command modifier is not used when issuing a LIST command)list_limit_maximum (type: integer, allowed: numbers, default: 500) — Maximum listed words limit for a list command (if the LIMIT command modifier is being used when issuing a LIST command)Under [store.kv]:
path (type: string, allowed: UNIX path, default: ./data/store/kv/) — Path to the Key-Value database store
retain_word_objects (type: integer, allowed: numbers, default: 1000) — Maximum number of objects a given word in the index can be linked to (older objects are cleared using a sliding window)
pool.inactive_after (type: integer, allowed: seconds, default: 1800) — Time after which a cached database is considered inactive and can be closed (if it is not used, ie. re-activated)
database.flush_after (type: integer, allowed: seconds, default: 900) — Time after which pending database updates should be flushed from memory to disk (increase this delay if you encounter high-CPU usage issues when a flush task kicks-in; this value should be lower than store.kv.pool.inactive_after)
database.compress (type: boolean, allowed: true, false, default: true) — Whether to compress database or not (uses Zstandard)
database.parallelism (type: integer, allowed: numbers, default: 2) — Limit on the number of compaction and flush threads that can run at the same time
database.max_files (type: integer, allowed: numbers, no default) — Maximum number of database files kept open at the same time per-database (if any; otherwise there are no limits)
database.max_compactions (type: integer, allowed: numbers, default: 1) — Limit on the number of concurrent database compaction jobs
database.max_flushes (type: integer, allowed: numbers, default: 1) — Limit on the number of concurrent database flush jobs
database.write_buffer (type: integer, allowed: numbers, default: 16384) — Maximum size in KB of the database write buffer, after which data gets flushed to disk (ie. 16384 is 16MB; the size should be a multiple of 1024, eg. 128 * 1024 = 131072 for 128MB)
database.write_ahead_log (type: boolean, allowed: true, false, default: true) — Whether to enable Write-Ahead Log or not (it avoids losing non-flushed data in case of server crash)
Under [store.fst]:
path (type: string, allowed: UNIX path, default: ./data/store/fst/) — Path to the Finite-State Transducer database store
pool.inactive_after (type: integer, allowed: seconds, default: 300) — Time after which a cached graph is considered inactive and can be closed (if it is not used, ie. re-activated)
graph.consolidate_after (type: integer, allowed: seconds, default: 180) — Time after which a graph that has pending updates should be consolidated (increase this delay if you encounter high-CPU usage issues when a consolidation task kicks-in; this value should be lower than store.fst.pool.inactive_after)
graph.max_size (type: integer, allowed: numbers, default: 2048) — Maximum size in KB of the graph file on disk, after which further words are not inserted anymore (ie. 2048 is 2MB; the size should be a multiple of 1024, eg. 8 * 1024 = 8192 for 8MB; use this limit to prevent heavy graphs to be consolidating forever; this limit is enforced in pair with store.fst.graph.max_words, whichever is reached first)
graph.max_words (type: integer, allowed: numbers, default: 250000) — Maximum number of words that can be held at the same time in the graph, after which further words are not inserted anymore (use this limit to prevent heavy graphs to be consolidating forever; this limit is enforced in pair with store.fst.graph.max_size, whichever is reached first)
Some configuration keys —namely server.log_level, channel.inet,
channel.auth_password, store.kv.path and store.fst.path— support
environment variable interpolation. If you set "${env.SECRET}" for one of
those keys, the value will be expanded from the SECRET environment variable.