Configuration options for the Release CLI


By default, release will store its configuration file at $HOME/.release.yaml. There are two methods for overriding the default configuration:
  1. 1.
    Set the RELEASE_CONFIG environment variable to another file path containing your configuration.
  2. 2.
    Provide the path to a different configuration file to the --config flag as part of a command.


The configuration file contains the following settings fields, which will be used globally unless overridden:
  • account (optional): The name or ID of the default Release account
  • app (optional): The name or ID of the default Release app
If you would like to avoid specifying the --account flag on each release command, update your $HOME/.release.yaml with the following:
Optionally, you can set this through the environment variable, as specified below.

Environment variables

Any setting can be overriden by an environment variable named RELEASE_<KEY>. For example, to override account, set RELEASE_ACCOUNT=MyAccount.