Environment Variables

Path to the alembic config file

Include schemas in alembic migrations.

Which app harness driver to use.

Arguments to pass to the app harness driver.

Whether to run app harness tests in headless mode.

The npm registry to use.

Used by flexgen to enumerate the pages.

How long to wait between automatic reload on frontend error to avoid reload loops.

Deprecated in favour of REFLEX_AUTO_RELOAD_COOLDOWN.

The timeout for the backend to do a cold start.

Whether to run the backend only. Exclusive with REFLEX_FRONTEND_ONLY.

The port to run the backend on.

Whether to check for outdated package versions.

Serve React's production build under the Vite dev server (experimental).

The directory to store reflex dependencies.

Enables different behavior for when the backend would do a cold start if it was inactive.

Enable full logging of debug messages to reflex user directory.

This env var stores the execution mode of the app

Extra plugins to append to the config's plugins list.

Whether to run the frontend only. Exclusive with REFLEX_BACKEND_ONLY.

The port to run the frontend on.

Paths to exclude from the hot reload. Takes precedence over include paths. Separated by a colon.

Additional paths to include in the hot reload. Separated by a colon.

Paths to override in the hot reload. Takes precedence over include and exclude paths. Separated by a colon.

The address to bind the HTTP client to. You can set this to "::" to enable IPv6.

Whether to ignore the redis config error. Some redis servers only allow out-of-band configuration.

The path to the reflex log file. If not set, the log file will be stored in the reflex user directory.

Emit logs as machine-readable JSON records instead of rich console output.

Read by the generated postcss.config.js to skip autoprefixer in preview mode.

Whether to opportunistically hold the redis lock to allow fast in-memory access while uncontended.

How long to opportunistically hold the redis lock (must be less than the token expiration).

Deprecated in favour of REFLEX_OPLOCK_HOLD_TIME.

In which performance mode to run the app.

Whether to skip purging the web directory in dev mode.

Whether to keep React's development-build owner-stack capture in dev mode. Reflex disables it by default because the per-element Error() capture dominates dev-mode render CPU on large pages; enable it to restore full owner stacks in React DevTools and dev warnings.

Cap on connections in each redis client's pool; unset means unbounded. At the cap, callers wait for a free connection instead of opening a new one. Pub/sub listeners hold a connection each, so leave headroom.

How long to wait for a free redis connection once REFLEX_REDIS_MAX_CONNECTIONS is reached.

Referrer identifier appended (urlencoded) to the "Built with Reflex" badge link as https://reflex.dev/?ref=<value>. Read at compile time.

The interval to send a ping to the websocket server.

Maximum size of the message in the websocket server in bytes.

The timeout to wait for a pong from the websocket server.

Whether to enable SSR for the frontend.

The working directory for the states directory.

How long to delay writing updated states to disk. (Higher values mean less writes, but more chance of lost data.)

Deprecated in favour of REFLEX_STATE_MANAGER_DISK_DEBOUNCE.

Whether to enable debug logging for the redis state manager.

The maximum size of the reflex state in kilobytes.

Whether to run Granian in a spawn process. This enables Reflex to pick up on environment variable changes between hot reloads.

The directory to store uploaded files.

Whether to use Granian for the backend. By default, the backend uses Uvicorn if available.

Whether to use npm over bun to install and run the frontend.

Whether to use the system installed bun. If set to false, bun will be bundled with the app.

Pre-transform all route modules when the Vite dev server starts (experimental).

The working directory for the frontend directory.

Whether to print the SQL queries if the log level is INFO or lower.

The maximum overflow size of the database connection pool.

Whether to check db connections before using them.

Recycle connections after this many seconds.

The size of the database connection pool.

The timeout for acquiring a connection from the pool.

Disable SSL verification for HTTPX requests.

Whether to enable Rolldown's experimental HMR.

Whether to force a full reload on changes.

Whether to enable hot module replacement

Whether to minify the frontend build output. Disabled by preview mode for readable bundles.

Whether to generate sourcemaps for the frontend.