Skip to content

Latest commit

 

History

History
98 lines (57 loc) · 2.61 KB

change-configuration-settings-dba4eb6.md

File metadata and controls

98 lines (57 loc) · 2.61 KB

Change Configuration Settings

Change the configuration settings to customize the behavior of the btp CLI.

Context

There are a few configuration settings that you can set to customize how the btp CLI works.

These settings are saved to the configuration file, which governs how the btp CLI works. You can have more than one configuration file for working in different accounts at the same time by logging in with the --config PATH option and then also providing it with each command call. See Specify the Location of the Configuration File.

To find out where the configuration file is stored, use btp --info. Use the following commands to manage your configuration settings:

Procedure

  1. To change a setting, run:

    btp [OPTIONS] set config [--format FORMAT] [--verbose BOOL] [--target.hierarchy BOOL]
    

    --format FORMAT

    The output format of commands. Valid values: text (default), json

    --verbose BOOL

    If set to true, command output includes tracing information for support. Valid values: false (default), true

    --target.hierarchy BOOL

    If set to true, btp target displays the full hierarchy of all global accounts. Valid values: false (default), true

    See Set a Target for Subsequent Commands with btp target.

    --login.sso MODE

    Single sign-on mode of btp login. Valid values: none (default), browser, manual. For example, if you want btp login to always open a browser for login at your identity provider, use btp set config --login.sso browser.

  2. To list the current settings, run:

    btp [OPTIONS] list config
    
  3. To reset individual or all settings back to their default values, run:

    btp [OPTIONS] reset config [--format] [--verbose] [--target.hierarchy] [--all]
    

Related Information

Specify the Location of the Configuration File