CLI‑config

--config

Use a specific TOML config file.

--config <path>

Default: ~/.config/kei/config.toml.

If the default path doesn't exist, kei uses built-in defaults plus env/bootstrap values. If you pass --config explicitly and the file is missing, kei errors.

Usage

kei sync --config /path/to/config.toml
kei status --config /path/to/config.toml
kei config setup --config /path/to/config.toml

How it fits current kei

TOML is the durable config surface. Put stable settings such as username, download directory, libraries, albums, metadata writes, watch interval, and server port in the config file.

Runtime CLI flags still override runtime behavior for one invocation. Examples: --dry-run, --recent, --password-file, and --log-level.

Docker

The Docker image runs:

kei service run --config /config/config.toml

Mount a config directory at /config and put config.toml there.

Related

• Configuration
• v0.20 Migration