Skip to main content

System status variables

The System status page reflects read-only snapshots of process environment variables. Update values by exporting them in your shell or editing .env, then restart the app so Next.js and background workers load the new configuration.

Managing variables​

  • Temporary override: export VAR_NAME=value && npm run dev
  • Persistent change: edit .env (or .env.local) and restart the application.
  • Secrets: prefer .env.local or deployment-specific secret managers so changes stay out of version control.

The sections below list every toggle shown in the System status panel along with the default value bundled with the platform. Follow the related links for deeper feature documentation where available.

Profiling filters​

OM_PROFILE​

Default: (unset)
Enables the backend tree profiler for requests matching the provided comma-separated filters. Useful for inspecting slow paths in server handlers. Related docs: Profiling.

NEXT_PUBLIC_OM_PROFILE​

Default: (unset)
Activates the tree profiler in the browser bundle so client-rendered flows can emit the same snapshots. Set alongside OM_PROFILE when debugging end-to-end latency.

OM_CRUD_PROFILE​

Default: (unset)
Targets CRUD factory operations with fine-grained profiling filters. Enables [crud:profile] payloads for measuring database access patterns.

OM_QE_PROFILE​

Default: (unset)
Turns on hybrid query engine profiling. Use it to verify whether requests hit the JSONB index or fall back to relational queries.

Logging​

QUERY_ENGINE_DEBUG_SQL​

Default: false
Logs every SQL statement dispatched by the hybrid query engine. Enable temporarily when troubleshooting filters or sorting behaviour. Related docs: Query index.

LOG_VERBOSITY​

Default: (unset)
Overrides structured log verbosity (debug, trace, etc.) across the backend. Leave blank to inherit module defaults or per-service settings.

LOG_LEVEL​

Default: (unset)
Fallback log level when verbosity is not specified. Common values: info, warn, error.

Cache controls​

ENABLE_CRUD_API_CACHE​

Default: false
Toggles the CRUD API response cache layer. When enabled, GET requests served by the CRUD factory reuse cached payloads within the TTL window.

CACHE_STRATEGY​

Default: memory
Selects the cache backend. Supported values include memory (in-process) and sqlite. Related docs: Cache tuning.

CACHE_TTL​

Default: (unset)
Optional override for cache time-to-live in milliseconds. Leave blank to use per-handler defaults.

CACHE_SQLITE_PATH​

Default: ./data/cache.db
Filesystem path for the SQLite cache file used when CACHE_STRATEGY=sqlite. Ensure the process has write permissions at this location.

Query index maintenance​

SCHEDULE_AUTO_REINDEX​

Default: true
Schedules background reindex jobs automatically when coverage gaps are detected. Disable if you prefer to handle reindexing manually through the CLI or queue workers.

OPTIMIZE_INDEX_COVERAGE_STATS​

Default: false
Caches coverage statistics instead of recalculating them on every read. Suitable for large datasets where immediate precision is less critical.

FORCE_QUERY_INDEX_ON_PARTIAL_INDEXES​

Default: true
Allows the hybrid engine to serve results even when coverage is partial. Responses include an x-om-partial-index header so admins can schedule a rebuild. Related docs: Query index.

Entity compatibility​

ENTITIES_BACKCOMPAT_EAV_FOR_CUSTOM​

Default: false
Mirrors custom-entity writes into the legacy EAV tables. Enable only when migrating integrations that still depend on the older schema.