dcos config set

Adding or setting DC/OS configuration properties

Description

The dcos config set command will add or set a property in the configuration file used for the current cluster. Table 1 shows the available properties.

Usage

  1. dcos config set <name> <value> [flags]

Options

NameDescription
—help, hDisplay usage.

Positional arguments

NameDescription
<name>The name of the property
<value>The value of the property

Table 1 - Properties

NameValue
core.dcos_acs_tokenThe DC/OS authentication token. When you log into the DC/OS CLI using dcos auth login, it stores the authentication token value locally. For more information, see the IAM API.
core.dcos_urlThe public master URL of your DC/OS cluster
core.mesos_master_urlThe Mesos master URL. Defaults to core.dcos_url
core.paginationIndicates whether to paginate output. Defaults to true.
core.ssl_verifyIndicates whether to verify SSL certificates or set the path to the SSL certificates
core.timeoutThe request timeout in seconds, with a minimum value of 1 second. Defaults to 3 minutes.
core.ssh_userThe user used when using ssh to connect to a node of your DC/OS cluster. Defaults to “core”.
core.ssh_proxy_ipWhether to use a fixed ssh proxy host (Bastion) for node SSH access.
core.reportingWhether to report usage events to Mesosphere.
core.prompt_loginWhether to prompt the user to log in when token expired; otherwise automatically initiate login.
cluster.nameHuman readable name of cluster.
job.urlApi URL for talking to the Metronome scheduler.
job.service_nameThe name of the metronome cluster.
marathon.urlBase URL for talking to Marathon. It overwrites the value specified in core.dcos_url.
package.cosmos_urlBase URL for talking to Cosmos. It overwrites the value specified in core.dcos_url.

Examples

Set request timeout

In this example, the request timeout is set to five minutes.

  1. dcos config set core.timeout 300

If the command is successful, no confirmation will be displayed. To verify that the property was set, run dcos config show:

  1. dcos config show
  2. cluster.name user_13-3fwr25e
  3. core.dcos_acs_token ********
  4. core.dcos_url http://user_13-elasticl-1x5proho90v2b-1931064628.us-east-1.elb.amazonaws.com
  5. core.timeout 300

Set SSL setting

In this example, verification of SSL certificates for HTTPS is set to true.

  1. dcos config set core.ssl_verify true

If the command is successful, no confirmation will be shown.

To verify that the property has been set, use dcos config show:

  1. [core.ssl_verify]: set to 'true'

Parent command

CommandDescription
dcos configManage DC/OS configuration