Configuration & Availability

ReferenceConfiguration

This page is the source of truth for the availability badge on every feature page. If a feature page says it is opt-in, the flag that turns it on is listed here.

What the badges mean

Stable On by default · production-ready

Opt-in Implemented · off by default — enable with enable_example = true

Beta Works · surface still evolving · works, surface still evolving

Roadmap Planned · not yet usable

Badge	Meaning
Stable	On by default, production-ready.
Opt-in	Implemented, off by default — set the listed flag to enable.
Beta	Works today, but the surface may still change.
Roadmap	Documented for direction; not yet usable.

Runtime feature flags

Set these on the server (in RuntimeConfig) when starting the daemon.

Flag	Default	Availability	Feature
`enable_acube_storage`	`true`	Stable	Core columnar storage engine.
`enable_spectral_fk`	`true`	Stable	Spectral foreign keys.
`enable_nervous_system`	`true`	Stable	Cognitive Schema reactive metadata.
`enable_jit`	`false`	Opt-in	Whole-query JIT compilation.
`enable_parallel`	`false`	Opt-in	Morsel-driven parallelism.
`enable_htap`	`false`	Opt-in	HTAP Delta-over-Sealed tier with snapshot isolation.
`join_graph_auto`	`true`	Stable	Automatic Join-Graph capture for eligible joins. Turn off with `--disable-join-graph` / `AETHERIUS_DISABLE_JOIN_GRAPH`.
`enable_autonomous_indexing`	`false`	Opt-in	Autonomous indexing — build `eif_auto_*` indexes from observed query patterns.

Ingestion flags

Flag	Where	Availability	Effect
`BULK_PULSE_V2=1`	Env var at daemon start	Opt-in	Routes `COPY` through the high-throughput projection path. Without it, the standard per-row path is used — same results, lower throughput.
`AETHERIUS_COMPRESS_RESIDENT=1`	Env var at daemon start	Opt-in	Keep sealed cubes LZ4-compressed in RAM, decompressing on scan. Lowers memory at the cost of some read CPU; results are identical. Default keeps zero-copy resident reads.
`AETHERIUS_INGEST_SPILL=1`	Env var at daemon start	Opt-in	Bound ingest RAM: evict each cube’s columns from memory as soon as it is flushed durably, reloading from disk on scan. Use for sustained bulk loads on memory-tight hosts. Not automatic — it spills every flush when set.

Daemon command-line flags

Set these on the aetheriusd command line.

Flag	Default	Purpose
`--data-dir <PATH>`	`./aetherius-data`	Where data is stored.
`--port <N>`	`5678`	PostgreSQL pgwire port.
`--native-port <N>`	`5679`	Native binary protocol port.
`--flight-port <N>`	`8815`	Arrow Flight SQL port.
`--disable-flight`	off	Don’t start the Flight SQL listener.
`--disable-native`	off	Don’t start the native listener.
`--disable-join-graph`	off	Disable automatic Join-Graph capture (deterministic planning). Env: `AETHERIUS_DISABLE_JOIN_GRAPH`.
`--native-auth-token <TOK>`	none	Require a bearer token on the native protocol. Env: `AETHERIUS_NATIVE_AUTH_TOKEN`.
`--flight-auth-token <TOK>`	none	Require a bearer token on Flight SQL. Env: `AETHERIUS_FLIGHT_AUTH_TOKEN`.

Wire endpoints at a glance

Protocol	Default port	Driver
Native (Aether-Sync)	`5679`	`pip install aetherius`
PostgreSQL pgwire	`5678`	`psycopg`, `asyncpg`, SQLAlchemy
Arrow Flight SQL	`8815`	`adbc-driver-flightsql`