blossom help:env_vars

cli reference 1 min read

Explain CLI environment variables

Usage

blossom help:env_vars

Blossom CLI environment variables

Environment variables can set global CLI behavior or provide defaults for command flags.

Authentication and context:

BLOSSOM_API_URL      Use a specific Blossom API endpoint.
BLOSSOM_TOKEN        Use an API token without saved login credentials.
BLOSSOM_ACCOUNT      Assert the token’s Account; does not switch Accounts.
BLOSSOM_PROFILE      Select a saved local CLI profile for one command.

Output and paging:

BLOSSOM_OUTPUT       Select output mode: text or json.
BLOSSOM_COLOR        Select auto, always, or never terminal color.
BLOSSOM_PAGE_SIZE    Set the page size used by list commands.
BLOSSOM_PAGER        Select the pager for long interactive text output.

Time and logs:

BLOSSOM_TIMEZONE     Format log timestamps in a specific timezone.
BLOSSOM_TIME_FORMAT  Format log timestamps with 12h or 24h time.

Diagnostics:

BLOSSOM_LOG_LEVEL    Enable CLI diagnostic logs: silent, info, debug, or trace.

Command flag defaults:

Use this pattern:

BLOSSOM_<COMMAND>_<FLAG>

Blossom uppercases the command and flag names. Colons and dashes become underscores.

Examples:

export BLOSSOM_ENVIRONMENT_SHOW_ID=environment-100
blossom environment:show

export BLOSSOM_APP_SHOW_ID=app-100
blossom app:show

Explicit flags win over environment defaults:

export BLOSSOM_ENVIRONMENT_SHOW_ID=environment-100
blossom environment:show --id environment-200

Boolean values must be true or false when used as command flag defaults:

export BLOSSOM_LOGS_FOLLOW=true
blossom logs --environment environment-100

Docs:

https://docs.blossom88.com/docs/blossom-cli/environment-defaults/