The leaf CLI respects the following environment variables for configuration, authentication, and execution control.

LEAF_TOKEN

Provides a personal access token or scoped API key for authentication.

• Usage: Continuous integration (CI/CD) pipelines, scripts, and automated agents.
• Precedence: When LEAF_TOKEN is set, leaf uses it directly and skips reading credentials from ~/.config/leaf/credentials.json.
• Example:

  export LEAF_TOKEN="leaf_pat_your_api_key_here"
  leaf deploy --yes

LEAF_API

Overrides the default API endpoint URL.

• Default: https://api.leafcloud.in
• CLI Flag: --api <URL>
• Example:

  export LEAF_API="https://api.leafcloud.in"

LEAF_NO_BANNER

Disables the LeafCloud ASCII banner when set to 1.

• Default: Unset (banner displayed on interactive version checks and first run).
• Example:

  export LEAF_NO_BANNER=1

CI

Automatically recognized by leaf. When set in continuous integration platforms (such as GitHub Actions, GitLab CI, or CircleCI), the CLI automatically suppresses the decorative terminal banner.

System environment variables

• XDG_CONFIG_HOME: Overrides the base configuration directory (defaults to ~/.config). Credentials are stored in $XDG_CONFIG_HOME/leaf/credentials.json.
• HOSTNAME: Used during leaf login to name the device session (e.g., leaf on workstation). Defaults to computer if unset.