> ## Documentation Index
> Fetch the complete documentation index at: https://www.landbase.com/docs/llms.txt
> Use this file to discover all available pages before exploring further.

# Environment variables

> Complete reference for all LANDBASE_* environment variables recognized by landbase-cli.

# Environment variables

All environment variables recognized by landbase-cli are listed here. Variables are grouped by domain.

***

## Runtime API

These variables control how the CLI connects to the Landbase API.

| Variable | Description |
| - | - |
| `LANDBASE_API_KEY` | API key for non-interactive authentication. Prefix: `lbk_`. Takes precedence over the key stored in `~/.landbase/config.json`. |
| `LANDBASE_API_BASE_URL` | Override the search API base URL. Must be a `*.landbase.com`, `localhost`, or `127.0.0.1` URL. Requires `LANDBASE_ALLOW_CUSTOM_API_URL=1` for other hosts. |
| `LANDBASE_API_OAUTH_URL` | Override the OAuth base URL. |
| `LANDBASE_PLATFORM_API_URL` | Override the platform gateway URL (default: `https://api.landbase.com`). Setting this opts into platform mode. |
| `LANDBASE_PLATFORM_WEB_URL` | Override the platform web URL (default: `https://platform.landbase.com`). |
| `LANDBASE_LEGACY_MODE` | Set to `1` to force legacy mode (direct AgentOS, API key auth) instead of platform mode. |
| `LANDBASE_ALLOW_CUSTOM_API_URL` | Set to `1` to bypass the API URL allowlist. Development use only. |

***

## Configuration

These variables control CLI behavior and config file locations.

| Variable | Description |
| - | - |
| `LANDBASE_CONFIG_DIR` | Override the config directory (default: `~/.landbase`). |
| `LANDBASE_NO_UPDATE_CHECK` | Set to `1` to disable the daily version-available check. Also disabled when `CI=1`. |
| `LANDBASE_NO_TELEMETRY` | Set to `1` to disable anonymous usage telemetry. |

***

## Installer only

These variables are used by `install.sh` and `install.ps1` only — they have no effect at runtime.

| Variable | Description |
| - | - |
| `LANDBASE_INSTALL_URL` | Override the binary download base URL. Must be an allowed URL or `LANDBASE_ALLOW_CUSTOM_URL=1` must be set. |
| `LANDBASE_INSTALL_DIR` | Override the installation directory. |
| `LANDBASE_INSTALL_SKIP_AUTH` | Set to `1` to skip the post-install browser login prompt. |
| `LANDBASE_INSTALL_SKIP_PATH` | Set to `1` to skip PATH configuration during install. |
| `LANDBASE_ALLOW_CUSTOM_URL` | Set to `1` to bypass the installer URL allowlist. Development use only. |
| `LANDBASE_VERSION` | (PowerShell installer) Pin a specific version to install instead of latest. |

***

## External agent detection

These variables are set by external tools and detected by landbase-cli for telemetry.

| Variable | Set by | Purpose |
| - | - | - |
| `CLAUDE_CODE_SESSION_ID` | Claude Code | Detected to associate CLI runs with a Claude Code session |
| `CODEX_THREAD_ID` | Codex CLI | Detected to associate CLI runs with a Codex thread |
| `CI` | CI systems | When set to `1`, disables the update-available check |

***

## Related

* [How to automate with scripts](https://www.landbase.com/docs/guides/how-to/automate-with-scripts.md) — using env vars in CI
* [Platform mode vs. legacy mode](https://www.landbase.com/docs/overview/concepts/platform-vs-legacy.md) — `LANDBASE_LEGACY_MODE` explained
* [config files reference](https://www.landbase.com/docs/reference/config-files.md) — where credentials are stored on disk


This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.