Runtime Environment Variables

Host variables that configure Elide itself.

These configure Elide. Guest code sees them in process.env like any other variable.

VariablePurpose
ELIDE_HOMEInstall directory for Elide versions. Default $XDG_DATA_HOME/elide or ~/.local/share/elide.
ELIDE_AUTO_INSTALL1 downloads a pinned .elideversion without asking.
ELIDE_LOCALECLI locale, as --locale.
ELIDE_LOGLog filter, e.g. debug.
ELIDE_LOG_STYLELog color: auto, always, or never.
ELIDE_ERROR_FORMATplain forces plain uncaught-error output, as --error-format=plain.
ELIDE_EDITORcode or idea links error locations to VS Code or IntelliJ. Uses EDITOR if unset.
ELIDE_CRASH_ROOTDirectory for crash reports.
ELIDE_AGENT1 forces agent output; 0 turns agent detection off. See AI Agents.
ELIDE_MCP_TOKENToken for elide mcp --mode http. Random if unset.
ELIDE_DEFER_EXITLinux: 0 makes the process free its memory before it exits.
ELIDE_SYS_TMPSet by Elide: the system temporary directory.
ELIDE_HTTP_USER_AGENTUser-Agent for fetch. Default Elide/<version>.
ELIDE_HTTP_NATIVE_WORKERSHTTP server workers for the v2 transport. Default cores ÷ 4, between 1 and 8.
ELIDE_NETTY_EVENT_LOOPSHTTP client and server I/O threads. Default min(4, cores).
ELIDE_TRANSPORT_V21, true, yes, or on selects --transport=v2 when no flag is given.
ELIDE_HTTP_FALLBACKv1 serves Unix domain socket requests through nio; none (default) fails them.
NODE_TLS_REJECT_UNAUTHORIZED0 disables TLS certificate checks for fetch. Warns once.
NODE_USE_SYSTEM_CA1 trusts the system certificate store for fetch.
NODE_EXTRA_CA_CERTSPEM file of extra CA certificates for fetch.
ELIDE_MAVEN_TLS_EXTRA_CAPEM file of extra CA certificates for Maven downloads.
ELIDE_PKGST_NPM_ENDPOINTnpm proxy URL for --pkgst. Default https://npm.pkg.st.
ELIDE_PKGST_PYPI_ENDPOINTPyPI proxy URL for --pkgst. Default https://pypi.pkg.st.
ELIDE_REMOTE_CACHEShared build cache URL. See Build cache.
ELIDE_REMOTE_CACHE_TOKENBearer token for the shared cache.
ELIDE_REMOTE_CACHE_USERNAMEBasic-auth user for the shared cache.
ELIDE_REMOTE_CACHE_PASSWORDBasic-auth password for the shared cache.
ELIDE_REMOTE_CACHE_POLICYeager (default) or smart.
ELIDE_REMOTE_CACHE_PULLfalse stops downloads from the shared cache.
ELIDE_REMOTE_CACHE_PUSHfalse stops uploads to the shared cache.
ELIDE_BUILD_TELEMETRY1, a file, or a directory writes a build trace (Build Tasks).
ELIDE_KOTLINC_ABI_STRIP1 with kotlinc --abi-only also strips function bodies.
ELIDE_WORKER_CLASSPATH_CACHE0 turns javac --classpath-cache off.

Diagnostics

VariablePurpose
ELIDE_ENGINE_LOGPrint low-level runtime log records to stderr.
ELIDE_DIAG_STARTUPPrint startup phase timings to stderr.
ELIDE_TRANSPORT_DIAGNOSTICS1 prints network transport statistics to stderr.