Skip to main content
Configuration

Environment Variables

Configure RivetKit runtime behavior with environment variables for the inspector, storage, and logging.

These variables configure the RivetKit SDK inside your own process. Variables that connect your node to a Rivet control plane, select a node pool, or configure the local control plane live in Environment Variables in the platform docs.

Inspector

Environment VariableDescription
RIVET_INSPECTOR_DISABLESet to 1 to disable the inspector

Experimental

Environment VariableDescription
RIVET_EXPERIMENTAL_OTELSet to 1 to enable experimental OTel tracing in Rivet Actors

Storage

Environment VariableDescription
RIVETKIT_RUNTIMERuntime binding to use for RivetKit core: auto, native, or wasm. Defaults to auto.
RIVETKIT_STORAGE_PATHWhere the local development control plane keeps Rivet Actor data, in a .rivetkit folder inside this directory. Defaults to your home directory.

Logging

Environment VariableDescription
RIVET_LOG_LEVELLog level: trace, debug, info, warn, error, fatal, silent
RIVET_LOG_TARGETSet to 1 to include log target
RIVET_LOG_TIMESTAMPSet to 1 to include timestamps
RIVET_LOG_MESSAGESet to 1 to include message formatting
RIVET_LOG_ERROR_STACKSet to 1 to include error stack traces
RIVET_LOG_HEADERSSet to 1 to log request headers