Environment Variables
This page covers the variables you set: on your own build workers, for the MCP server, and for your projects' builds.
Project build variables
Variables your app needs at build time (API keys, EXPO_PUBLIC_* values, registry
tokens) are stored per project, encrypted, and injected into each build. Set them in the
dashboard under Project → Settings, or with the MCP tools set_env_var,
list_env_vars, and delete_env_var. See the MCP guide.
Your GitHub token for private repositories is also a project variable — see the GitHub guide.
Customer worker (worker.env)
The Venelx Worker app reads ~/.venelx/worker.env (%USERPROFILE%\.venelx\worker.env on
Windows). Pairing from the app fills in the essentials for you; everything else is
optional. Set VENELX_WORKER_CONFIG to use a different file path.
| Variable | Default / example | Purpose |
|---|---|---|
WORKER_NAME | mac-studio-1 | Name shown in the dashboard; unique per machine |
WORKER_PAIRING_TOKEN | from the dashboard | Credential created when you pair the worker |
API_URL | https://api.venelx.com | Venelx API base URL |
WORKER_PLATFORMS | ios,android-preview,android-production | Platforms this worker accepts |
VENELX_WORKER_CONFIG | ~/.venelx/worker.env | Config file path |
OUTPUT_DIR | ~/.venelx/builds | Build workspace (logs, local artifacts) |
PROJECT_DIR | ~/.venelx/projects | Where repositories are checked out |
EXPO_TOKEN | — | Expo access token for EAS-managed steps |
ANDROID_HOME | /opt/android-sdk | Android SDK location (Android workers) |
BUILD_TIMEOUT_MINUTES | 60 | Per-build timeout |
WORKER_HEARTBEAT_INTERVAL_MS | 45000 | Heartbeat cadence |
WORKER_CLAIM_POLL_MS | 15000 | Job-claim poll interval |
WORKER_WS_HTTP_FALLBACK_MS | 30000 | Fall back to HTTP when the WebSocket has been down this long |
Whether a project uses only your workers or falls back to Venelx shared workers is a per-project setting (Project → Settings → General → Worker routing), not a worker variable.
MCP server (@venelx/mcp)
| Variable | Required | Default | Purpose |
|---|---|---|---|
VENELX_TOKEN | no | saved login | Personal API token (vx_...). Not needed after npx @venelx/mcp login, which saves a token to ~/.venelx/mcp-token. See API tokens |
VENELX_API_URL | no | https://api.venelx.com | API base URL |