https://pizza.rs/tags/environment/Recent content in Environment on INFINI PizzaHugoenhttps://pizza.rs/docs/references/configuration/env_vars/Mon, 01 Jan 0001 00:00:00 +0000https://pizza.rs/docs/references/configuration/env_vars/<h1 id="environment-variables"> Environment variables <a class="anchor" href="#environment-variables">#</a> </h1> <p>Most tuning lives in <code>pizza.yml</code> (see the <a href="https://pizza.rs/docs/references/configuration/pizza_yml/">configuration file reference</a>) or the runtime settings APIs. The <code>PIZZA_*</code> environment variables below are escape hatches — mostly for benchmarking, diagnostics and crash-safety research; prefer the config file or the settings APIs for anything you want to keep.</p> <h2 id="operational-knobs"> Operational knobs <a class="anchor" href="#operational-knobs">#</a> </h2> <table> <thead> <tr> <th>Variable</th> <th>Default</th> <th>Description</th> </tr> </thead> <tbody> <tr> <td><code>PIZZA_FLUSH_CONCURRENCY</code></td> <td>unset</td> <td>Overrides <code>node.flush_concurrency</code> (1..=16); beats the config file.</td> </tr> <tr> <td><code>PIZZA_RECOVERY_TAIL_FLUSH</code></td> <td>unset</td> <td><code>0</code>/<code>1</code> forces <code>wal.local.recovery_tail_flush</code> off/on, beating the config file.</td> </tr> <tr> <td><code>PIZZA_RPC_TIMEOUT_SECS</code></td> <td>unset</td> <td>Deadline for cluster RPC calls (must be &gt; 0).</td> </tr> <tr> <td><code>PIZZA_COMPACTION_EVERY_TICKS</code></td> <td>unset</td> <td>Maintenance ticks (500 ms) between background compaction passes.</td> </tr> <tr> <td><code>PIZZA_COMPACT_TIERS</code></td> <td>unset</td> <td>Restrict background compaction to specific tier patterns (diagnostics).</td> </tr> <tr> <td><code>PIZZA_FLUSH_AFTER_IDLE_TICKS</code></td> <td>unset</td> <td>Idle-tail epoch flush override (same semantics as <code>wal.local.epoch_flush_after_idle_ticks</code>).</td> </tr> <tr> <td><code>PIZZA_SEGMENT_SYNC</code></td> <td>unset</td> <td><code>off</code> skips the per-segment fsync before WAL purge — the same behavior as <code>wal.local.segment_durability: async</code>, without a config change.</td> </tr> <tr> <td><code>PIZZA_WAL_IO_URING</code></td> <td>unset</td> <td>Force WAL io_uring on/off (Linux), overriding auto-detection.</td> </tr> <tr> <td><code>PIZZA_MAX_NODE_BUILDS</code></td> <td>unset</td> <td>Fallback for the epoch-build concurrency default (<code>PUT /_node/_local/settings/epoch_build</code> overrides it at runtime).</td> </tr> <tr> <td><code>PIZZA_MERGE_POOL_THREADS</code></td> <td>unset</td> <td>Size of the dedicated compaction merge thread pool.</td> </tr> <tr> <td><code>PIZZA_ROUTE_CACHE</code></td> <td>unset</td> <td>Routing-table cache diagnostics/tuning.</td> </tr> <tr> <td><code>PIZZA_BUILD_BUF_POOL_MB</code></td> <td>unset</td> <td>Build-buffer pool size in MiB.</td> </tr> </tbody> </table> <h2 id="watchdog"> Watchdog <a class="anchor" href="#watchdog">#</a> </h2> <table> <thead> <tr> <th>Variable</th> <th>Default</th> <th>Description</th> </tr> </thead> <tbody> <tr> <td><code>PIZZA_RSS_WATCHDOG</code></td> <td>unset</td> <td>Enable the RSS watchdog (<code>0</code> explicitly disables it).</td> </tr> <tr> <td><code>PIZZA_RSS_SOFT_MB</code></td> <td>60% of MemTotal</td> <td>Soft RSS threshold (MiB) — sheds load, logs.</td> </tr> <tr> <td><code>PIZZA_RSS_HARD_MB</code></td> <td>75% of MemTotal</td> <td>Hard RSS threshold (MiB) — aborts the process.</td> </tr> </tbody> </table> <h2 id="diagnostics-and-profiling"> Diagnostics and profiling <a class="anchor" href="#diagnostics-and-profiling">#</a> </h2> <p>Off by default; presence enables.</p>