modality config

Command: modality config

Manages the modality CLI's configuration. Currently the only configuration value specifies where to find the modalityd daemon's API. Further configuration may be added.

Configuration can be set globally, or locally in the current working directory. If neither --global nor --local is specified this command defaults to the global configuration. When using the CLI the local configuration takes precedence over the global one.

If no options are supplied, modality config displays the Modality configuration values currently in use.

# Example

$ modality config --modalityd 'http://localhost:14181/v1/'

$ modality config
# Modality configuration
modalityd = 'http://localhost:14181/v1/'

# Options

--global - View or update the global configuration. This is the default behavior.

--insecure - Allow insecure TLS connections to modalityd. Setting this option disables TLS certificate verification but still encrypts traffic. The most common use case for this option is when modalityd is using a self-signed certificate. This option must be used together with the --modalityd option.

--local - View or update the local configuration for the current working directory.

--modalityd <modalityd> - Set the modalityd URL field. This field tells the CLI where to find the modalityd (modality's backend daemon) HTTP API. If not set, the default URL http://localhost:14181/v1/ will be used. Supports the following formats:

  • URL: http[s]://host:port/v<api-version>/
  • IP address and port: 127.0.0.1:14181 will be converted to http://127.0.0.1:14181/v1/
  • IP address: 0.0.0.0 will be converted to http://0.0.0.0:14181/v1/
  • Port number: 8080 will be converted to http://127.0.0.1:8080/v1/
  • Host: localhost will be converted to http://localhost:14181/v1/

--secure - Only allow secure TLS connections to modalityd. Setting this option enables TLS certificate verification. This option must be used together with the --modalityd option.

← modality delete →