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.

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.

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.

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