Skip to content

Configuration

ModelDock is zero-config by default. Customize when needed.

Config File Location

OS Path
Linux / macOS ~/.config/modeldock/config.toml
Windows %APPDATA%\modeldock\config.toml

Config File Format

default_backend = "ollama"
auto_install    = true
log_level       = "INFO"
progress_style  = "rich"

Environment Variables

Override config with MODELDOCK_* env vars:

Variable Description Default
MODELDOCK_LOG_LEVEL DEBUG/INFO/WARNING/ERROR ERROR
MODELDOCK_DEFAULT_BACKEND Runtime backend ollama
MODELDOCK_AUTO_INSTALL Auto-download missing models false
MODELDOCK_CACHE_DIR Override cache location platform default
MODELDOCK_CATALOG_SOURCE auto/ollama/bundled auto

Config Precedence (low to high)

  1. Built-in defaults
  2. Dynamic catalog (ollama.com)
  3. System config (<sys-prefix>/etc/modeldock)
  4. User config (~/.config/modeldock/config.toml)
  5. Environment variables (MODELDOCK_*)
  6. Explicit runtime overrides

CLI Config Commands

modeldock config show          # view current config
modeldock config set auto_install true   # change a setting

Programmatic Configuration

Override the singleton manager before first use:

import modeldock as md

md.configure(
    backend="ollama",
    auto_install=True,
    log_level="INFO",
    progress_style="rich",
    cache_dir="/custom/cache/path",
    ollama_host="http://localhost:11434",
)

Or create an isolated manager:

mgr = md.Manager(
    backend="ollama",
    auto_install=True,
    ollama_host="http://localhost:11434",
)

Catalog Source

Control which registry is used:

Value Behavior
auto Try dynamic, fallback to bundled (default)
ollama Dynamic only — requires internet
bundled Static catalog.json only — fully offline

Set via config file or MODELDOCK_CATALOG_SOURCE env var.

Next Steps