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.

It is deliberately the curated list. The exhaustive inventory of every command-line flag, every AETHERIUS_* environment variable, the SQL SET variables and the library-only RuntimeConfig fields, with defaults and instructions for systemd / launchd, is on Flags & Environment Variables.

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.
Premium	Exists only when the license key grants it. Contact the AetheriusDB team at aetheriusdb.com or aetheriuslabs.com.

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	Premium	HTAP Delta-over-Sealed tier with snapshot isolation. On the daemon this comes from the license key’s htap grant; --enable-htap alone does not turn it on.
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.

Read this before you rely on a feature

Earlier documentation described JIT compilation and morsel parallelism as “on by default.” They are not — both default to false and must be enabled with enable_jit = true / enable_parallel = true. This page reflects the actual defaults.

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.

Cluster mode and worker variables

Variable	Where	Availability	Effect
AETHERIUS_CLUSTER_MODE=1	Env var at daemon start; needs the key’s cluster grant	Beta · Premium	Boot as a cluster orchestrator: statements route to the workers named in the topology; single-table SELECTs, aggregates, GROUP BY and two-table joins compile to bytecode and run remotely. Decided once at boot. See Cluster Execution Engine.
AETHERIUS_TOPOLOGY_JSON / AETHERIUS_TOPOLOGY_FILE	Env var at daemon start	Beta	The topology document (inline, or a path; default cluster-topology.json in the data directory): clusters, addresses, owned tables, optional standby. A standby also starts a Shadow HA stream.
AETHERIUS_WORKER_MODE=<cluster>	Env var at daemon start; needs the key’s cluster grant	Beta · Premium	Boot as a worker for the named cluster. Binds only the worker port; no SQL surface.
AETHERIUS_WORKER_PORT	Env var at daemon start	Beta	Worker listening port. Default 5434.
AETHERIUS_WORKER_DATA_DIR	Env var at daemon start	Beta	The containers/ directory the worker discovers its blocks from at boot. Unset: the worker serves no data.
AETHERIUS_ENABLE_MULTI_TENANCY=1	Env var at daemon start (orchestrator and workers); needs the key’s multi_tenancy grant	Beta · Premium	Accept tenants other than the system tenant 0. Off: any other tenant is refused before routing (TenancyViolation, SQLSTATE 08P01). See Multi-Tenancy.
AETHERIUS_MAX_CONCURRENT_QUERIES_PER_TENANT	Env var at daemon start	Beta	Statements one tenant may have in flight at the orchestrator; the next is refused with RESOURCE_EXHAUSTED. Default 50.
AETHERIUS_TX_TIMEOUT	Env var at daemon start	Beta	Milliseconds a cluster transaction may stay open before the watchdog aborts it. Default 5000. See Cluster Transactions.
AETHERIUS_VACUUM_INTERVAL	Env var at daemon start (worker)	Beta	Seconds between vacuum sweeps of a worker’s files. Default 60. See Deletes, Updates & the Vacuum.
AETHERIUS_VACUUM_AGE_OUT=1	Env var at daemon start	Opt-in	Age-based retirement of superseded write-domain containers.

Daemon command-line flags

Set these on the aetheriusd command line.

Flag	Default	Purpose
--data-dir <PATH>	aetherius_data (relative to the working directory)	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.
--license-file <PATH>	/etc/aetherius/license.key	Signed license to enforce. Env: AETHERIUS_LICENSE_FILE. The default applies only if that file exists; without a valid license the daemon runs read-only.

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

Maturity of newer features

Features beyond the flags above (for example the deep-RL optimizer, the zero-trust FHE engine, and several cloud capabilities) carry their own availability badge on their feature page, verified as those pages are authored. When a maturity level is not yet confirmed, the page labels it Beta or Roadmap rather than implying it is ready.