> ## 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](/docs/how-to/automate-with-scripts) — using env vars in CI
* [Platform mode vs. legacy mode](/docs/explanation/platform-vs-legacy) — `LANDBASE_LEGACY_MODE` explained
* [config files reference](/docs/reference/config-files) — where credentials are stored on disk