Configuration
Configuring the Bluelink CLI
The Bluelink CLI can be configured using CLI options, a configuration file or environment variables. It is designed to have good defaults, but sometimes you will want to customise the behaviour.
Note
The order of precedence for configuration is:
- CLI options
- Environment variables
- Configuration file
- Default values
Configuration File
The CLI looks for a configuration file in the following locations by default:
$HOME/.bluelink/config/bluelink.config.ymlon Linux or macOS and%LOCALAPPDATA%\NewStack\Bluelink\config\bluelink.config.ymlon Windows.$HOME/.bluelink/config/bluelink.config.yamlon Linux or macOS and%LOCALAPPDATA%\NewStack\Bluelink\config\bluelink.config.yamlon Windows.$HOME/.bluelink/config/bluelink.config.jsonon Linux or macOS and%LOCALAPPDATA%\NewStack\Bluelink\config\bluelink.config.jsonon Windows.$HOME/.bluelink/config/bluelink.config.tomlon Linux or macOS and%LOCALAPPDATA%\NewStack\Bluelink\config\bluelink.config.tomlon Windows.
A custom configuration file can be specified using the --config flag.
You can explore values that can be configured in the CLI reference.
Environment Variables
The CLI can be configured using environment variables.
Environment variables prefixed with BLUELINK_CLI_ will be picked up by the CLI.
You can explore environment variables that can be configured in the CLI reference.
Auth Configuration File
Depending on the authentication method configured for the CLI, you will need to provide a separate configuration file for authenticating with the Deploy Engine.
By default, the CLI will look for a configuration file at $HOME/.bluelink/config/engine.auth.json on Linux or macOS and %LOCALAPPDATA%\NewStack\Bluelink\config\engine.auth.json on Windows.
This can be overridden using the --engine-auth-config-file option.