Docs › Reference
Environment variables
Every environment variable Relia's SDKs and command-line tools read, which SDK reads it, what it does and its default.
The variables your app and build can set to configure Relia. "Node" = relia-sdk on a server (relia-sdk/node), "Python" = relia-sdk on PyPI, "PHP" = tryrelia/relia (Laravel and plain PHP), "Edge" = relia-sdk/edge (Supabase Edge Functions, Deno, Cloudflare Workers, Vercel Edge). Switches turn off with 0, false, off or no unless a row says otherwise.
Note: the browser SDK (Relia.init) reads no environment variables: its settings are the options in src/relia.ts. The Node.js server SDK takes serviceName and projectId from relia.tracing.js (or instrumentation.ts), which init writes for you. The Python SDK also reads .env and .env.local in the current folder for variables not already set. Edge reads each variable from the function's options, then the Workers env bindings, then Deno.env / process.env.
Project and identity
| Variable |
SDKs |
What it does |
Default |
RELIA_PROJECT_ID |
Python, PHP, Edge, Node (AI runs, CLI) |
Your Relia project id (24 characters; on your project page under Setup Guide & SDK). |
None. PHP sends nothing without it. |
RELIA_KEY |
Node, Python, PHP, Edge |
The project key (relia_live_…), sent as the X-Relia-Key header. A wrong key for the project is refused; a missing one is accepted. |
None |
RELIA_SERVICE_NAME |
Python, PHP, Edge, Node (system) |
The service name shown in Relia. |
Python: OTEL_SERVICE_NAME, else backend. PHP: your APP_NAME in lower case with dashes, else php-app. Edge: the first part of the URL path, else edge-function. |
OTEL_SERVICE_NAME |
Python |
Used when RELIA_SERVICE_NAME is not set. |
None |
RELIA_ENV |
Python, PHP, Edge |
The environment name (production, staging…). Relia hides hosts from development environments by default. |
Python: ENVIRONMENT, else APP_ENV, else production. PHP: APP_ENV, else production. Edge: production. |
NODE_ENV |
Node |
The environment name on Node.js servers. |
development |
Where data goes
| Variable |
SDKs |
What it does |
Default |
RELIA_OTLP_ENDPOINT |
Node, Python, PHP, Edge, CLI |
Where traces go. /v1/traces is added when missing (Node, PHP). App logs go to the same address with /v1/logs. |
https://devotel.tryrelia.com/v1/traces |
OTEL_EXPORTER_OTLP_TRACES_ENDPOINT, OTEL_EXPORTER_OTLP_ENDPOINT |
Python |
Used, in that order, when RELIA_OTLP_ENDPOINT is not set. |
None |
RELIA_API_URL |
Node, Python, PHP, Edge, CLI |
Relia's API address: SDK settings, AI runs, the Laravel @reliaScript browser part, and the CLI. |
https://devreliaapi.tryrelia.com |
Versions and deploys
| Variable |
SDKs |
What it does |
Default |
RELIA_RELEASE |
Node, Python, PHP, Edge, CLI, Vite plugin |
The version of the running build, so Relia can tell deploys apart. Also the release name for source map uploads. |
Detected (see below) |
SERVICE_VERSION, OTEL_SERVICE_VERSION |
Node, Python, PHP |
Used, in that order, when RELIA_RELEASE is not set. |
None |
With none of these set, the version is detected: first the commit your CI or host exposes (GITHUB_SHA, VERCEL_GIT_COMMIT_SHA, RENDER_GIT_COMMIT, HEROKU_SLUG_COMMIT, SOURCE_VERSION, CF_PAGES_COMMIT_SHA, RAILWAY_GIT_COMMIT_SHA, CI_COMMIT_SHA, BITBUCKET_COMMIT, GIT_COMMIT; PHP also FORGE_SITE_BRANCH_COMMIT and LARAVEL_CLOUD_COMMIT), then the checked-out commit in .git, then your package version.
What is collected
| Variable |
SDKs |
What it does |
Default |
RELIA_ENABLED |
PHP, Edge |
Switch: off sends nothing. |
On |
RELIA_TRACING_DISABLED |
PHP |
Any value turns Relia off. |
Not set |
RELIA_LOGS |
Node, Python, PHP |
Switch for sending your app's warning and error log lines. |
On |
RELIA_LOG_LEVEL |
Python, PHP |
Lowest log level sent. |
Python WARNING, PHP warning |
RELIA_SYSTEM_METRICS |
Node, Python |
Switch for CPU, memory and disk of the machine. Node turns off only with false. |
On |
RELIA_SYSTEM_INTERVAL |
Node, Python |
Seconds between machine readings (at least 5). |
30 |
RELIA_DISABLE_INSTRUMENTATIONS |
Node, Python |
Comma-separated libraries not to trace. Node: fastify, bullmq, mcp. Python: requests, httpx, aiohttp, celery, botocore, boto3sqs, mcp. |
None |
RELIA_DB_BACKGROUND |
Node, Python |
1, true, yes or on also records database calls made outside a request or job. |
Off |
RELIA_QUERIES |
PHP (Laravel) |
Switch for database queries. |
On |
RELIA_HTTP_CLIENT |
PHP (Laravel) |
Switch for outgoing HTTP calls. |
On |
RELIA_QUEUE |
PHP (Laravel) |
Switch for queue jobs. |
On |
RELIA_REMOTE_SETTINGS |
Node, Python |
Switch for reading the project's SDK settings from Relia (every 10 minutes). |
On |
AI calls and agent runs
| Variable |
SDKs |
What it does |
Default |
RELIA_AI_CAPTURE |
Node, Python, Edge |
Switch for recording calls to OpenAI, Anthropic, Gemini and compatible APIs as AI runs. |
On |
RELIA_AGENT_ID |
Node, Python, Edge |
The AI agent's id in Relia. |
Node: derived from the agent name. Edge: the service name. |
RELIA_AGENT_NAME |
Node, Python, Edge |
The AI agent's name in Relia. |
The service or package name |
RELIA_AGENT_ENDPOINT |
Node, Python, Edge, CLI |
Where AI runs are sent. |
https://devreliaapi.tryrelia.com/api/v1/agents/runs |
RELIA_DEBUG |
Node |
Any value except 0, false or off prints a line per AI run. |
Off |
Serverless functions
| Variable |
SDKs |
What it does |
Default |
RELIA_SERVERLESS |
Node, Python |
1, true or on forces serverless mode (send before answering, no machine metrics). Detected by itself on Google Cloud / Firebase Functions, Cloud Run and AWS Lambda (Node also Vercel and Netlify). |
Off |
RELIA_FUNCTION_NAME |
Node, Python |
The function's name when serverless mode is forced. |
function |
RELIA_FLUSH |
Node, Python, Edge |
Node and Python: after keeps sending in the background instead of before each response. Edge: before always sends before answering (use it with supabase functions serve). |
Node and Python: before answering in serverless mode, in the background otherwise. Edge: after answering when the platform keeps the function alive for it. |
RELIA_FLUSH_TIMEOUT_MS |
Node, Python |
Longest wait to send before answering, in milliseconds (Node: 100 to 5000). |
1000 |
| Variable |
Used by |
What it does |
Default |
RELIA_TOKEN |
sourcemaps upload, Vite plugin |
The upload-only token for source maps. Also read from .env.local / .env in the folder. Set it in your host's environment variables for hosted builds. |
The login saved by init |
RELIA_MCP_TOKEN |
mcp, mcp install |
An MCP token (relia_mcp_…) for token mode. |
~/.relia/mcp.json |
RELIA_MCP_URL |
mcp, mcp install |
Relia's MCP address. |
mcp: the address saved by mcp install, else https://devreliaapi.tryrelia.com/mcp. mcp install: RELIA_API_URL + /mcp, else https://devreliaapi.tryrelia.com/mcp. |
RELIA_SESSION_ENDPOINT |
init |
The browser endpoint written into src/relia.ts. |
Relia's cloud API |
RELIA_APP_URL |
CLI |
The Relia app address used in printed links. |
https://app.tryrelia.com |
Next
Last checked against the product: 1 Nov 2026