Skip to content

config

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

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

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

Terminal window
ndcli config show

Shows:

  • OAuth2 settings (provider, domain, client ID)
  • Control plane host
  • Default organization
  • Output format preference
  • Auth storage settings
  • Config file location
Terminal window
ndcli config show
ndcli config show -f json

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

Terminal window
ndcli config set org [name]
ArgumentRequiredDescription
nameYesOrganization name to set as default
Terminal window
ndcli config set org my-company
ndcli config show
  • 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

Set the default output format for all commands.

Terminal window
ndcli config set output [format]
ArgumentRequiredDescription
formatYesOne of: table, simple, detailed, json
FormatDescription
tableTabular format, good for lists
simpleCompact bullet-point format
detailedRich Unicode box drawing (default)
jsonMachine-readable JSON
Terminal window
ndcli config set output json
ndcli config set output detailed

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

Terminal window
ndcli config reset
Terminal window
ndcli config reset