Skip to content

config

Configuration management commands for NDCLI. These commands help you view and modify NDCLI settings.

Commands

CommandDescription
config showDisplay current configuration
config set orgSet default organization
config set outputSet default output format
config resetReset configuration to defaults

config show

Display the current NDCLI configuration including all settings and their values.

Terminal window
ndcli config show

Output

Shows:

  • OAuth2 settings (provider, domain, client ID)
  • Control plane host
  • Default organization
  • Output format preference
  • Auth storage settings
  • Config file location

Examples

Terminal window
ndcli config show
ndcli config show -f json

config set org

Set the default organization for all commands. This saves you from specifying --org on every command.

Terminal window
ndcli config set org [name]

Arguments

ArgumentRequiredDescription
nameYesOrganization name to set as default

Examples

Terminal window
ndcli config set org my-company
ndcli config show

Notes

  • The organization must exist and you must have access to it
  • Use ndcli org list to see available organizations
  • Override per-command with the --org flag

config set output

Set the default output format for all commands.

Terminal window
ndcli config set output [format]

Arguments

ArgumentRequiredDescription
formatYesOne of: table, simple, detailed, json

Output Formats

FormatDescription
tableTabular format, good for lists
simpleCompact bullet-point format
detailedRich Unicode box drawing (default)
jsonMachine-readable JSON

Examples

Terminal window
ndcli config set output json
ndcli config set output detailed

config reset

Reset the configuration file to default values. This removes custom settings.

Terminal window
ndcli config reset

Examples

Terminal window
ndcli config reset