Global Configuration

Location

Dits asks the operating system for its user configuration directory and appends dits/config.toml. Typical locations are:

Linux:  $XDG_CONFIG_HOME/dits/config.toml or $HOME/.config/dits/config.toml
macOS:  ~/Library/Application Support/dits/config.toml
Windows: %APPDATA%/dits/config.toml

There is no ~/.ditsconfig file and no DITS_CONFIG_GLOBAL path override in the current CLI.

Use the global file

# List the global document
dits config --global --list

# Read or write a global key
dits config --global telemetry.enabled
dits config --global telemetry.enabled false

# Remove an optional stored preference
dits config --global --unset user.email

Outside a repository, dits config and dits config --list also select this file. Keyed operations outside a repository still require --global.

What has a global runtime effect?

telemetry.enabled is the one public key currently loaded directly from the global file. Telemetry is disabled by default; the dedicated commands are the clearest way to manage it:

dits telemetry status
dits telemetry enable
dits telemetry disable

Global user.*, core.*, and chunking.* values can be stored, but repository operations do not currently inherit them. In particular, commit identity comes from the author environment variables documented on the environment page.

Unsupported global settings

Aliases, credential helpers, editors, pagers, global ignore files, transfer limits, pull/push defaults, colors, and signing keys are design work. The current setter rejects those keys.

Related topics

• Configuration overview
• Repository configuration
• Environment variables