Configuration¶

This page explains how to configure drove CLI for single and multi-cluster access.

Config file location¶

drove reads config from ~/.drove by default. Override with -f:

drove -f /path/to/config cluster ping

Single cluster setup¶

Minimal config:

[DEFAULT]

[mycluster]
endpoint = https://drove.example.com
auth_header = Bearer eyJhbGc...
# or
username = admin
password = admin

Multi-cluster setup¶

[DEFAULT]
current_cluster = prod

[staging]
endpoint = https://drove-staging.example.com
username = admin
password = admin123
insecure = true

[prod]
endpoint = https://drove.example.com
auth_header = Bearer eyJhbGc...

Switch clusters:

drove config use-cluster staging
drove cluster summary  # Now hits staging

drove -c prod cluster summary  # One-off override

Authentication¶

drove supports two auth methods:

Method	Config
Basic	`username` + `password`
Token	`auth_header`

Basic auth:

[mycluster]
endpoint = https://drove.example.com
username = myuser
password = mypass

Token auth:

[mycluster]
endpoint = https://drove.example.com
auth_header = Bearer eyJhbGc...

Note

If both are set, basic auth takes precedence.

Variable interpolation¶

Avoid repeating tokens:

[DEFAULT]
current_cluster = prod
prod_token = Bearer eyJhbGc...

[prod]
endpoint = https://drove.example.com
auth_header = %(prod_token)s

[prod-readonly]
endpoint = https://drove.example.com
auth_header = %(prod_token)s

SSL verification¶

Skip certificate verification for insecure clusters:

[internal]
endpoint = https://drove.internal
insecure = true

Command line overrides¶

Any config option can be overridden:

drove -e https://drove.example.com -u admin -p secret cluster ping
drove -c prod --insecure cluster summary

Manage config with drove¶

# Initialize new config
drove config init -e https://drove.example.com -n prod -t "Bearer xxx"

# Add cluster
drove config add-cluster staging -e https://staging.example.com -u admin -p pass

# List clusters
drove config get-clusters

# Switch default
drove config use-cluster staging

# View config
drove config view