Downcity
Configuration

Configuration Overview

Understand console-global vs agent-local configuration layers

Configuration Overview

Recommended configuration layers:

  1. Console-global layer for shared resources (for example model pool).
  2. Agent project layer for runtime binding and behavior.

Core principles

  1. Define models at console level.
  2. Agent only binds via model.primary.
  3. Restart agent after config changes to verify apply behavior.

Most edited locations

  1. ~/.ship/ship.db (managed through CLI/UI, not direct manual edits)
  2. <project>/ship.json

Next

  1. Console ship.json
  2. Project Configuration (ship.json)
  3. Environment Variable Strategy (Console Shared vs Agent Private)
  4. Model Configuration (Console + Agent)
  5. Configuration Checklist

Table of Contents