Storage engine configuration reference
For background on the upgraded storage engine, see Storage engine.
This page provides a complete reference for the upgraded storage engine configuration options.
If an option is omitted, the server either derives a value from the existing
influxdb3 serve configuration or falls back to an engine-specific default
that balances resource usage and throughput.
Most of the options on this page are tuning options that do not appear in the
default influxdb3 serve --help output; use --help-all to list them.
The pt- option prefix was removed
Upgraded storage engine options no longer use the pt- prefix—for example,
--pt-snapshot-size is now --snapshot-size.
There is no backward compatibility for the old option names:
old --pt-* flags cause a startup error, and legacy INFLUXDB3_PT_* and
INFLUXDB3_ENTERPRISE_PT_* environment variables are ignored.
The server logs a warning at startup for each INFLUXDB3_PT_* or
INFLUXDB3_ENTERPRISE_PT_* environment variable that is still set.
The following options were folded into engine-agnostic options shared with the Parquet-based engine:
--pt-wal-flush-interval→--wal-flush-interval--pt-wal-replication-interval→--replication-interval--pt-file-cache-size→--file-cache-size--pt-file-cache-recency→--file-cache-recency