> ## Documentation Index
> Fetch the complete documentation index at: https://docs.magnitude.dev/llms.txt
> Use this file to discover all available pages before exploring further.

# Configuration file

> Every key in config.json.

Magnitude reads `~/.magnitude/config.json`, or `%USERPROFILE%\.magnitude\config.json` on Windows. **Settings** writes the same file. Keys Magnitude does not know are preserved.

```json theme={"theme":{"light":"github-light","dark":"github-dark"}}
{
  "appearance": "system",
  "autoDownloadUpdates": true,
  "modelsDirectory": "/Volumes/SSD/Magnitude/models",
  "network": {
    "enabled": true,
    "bind": "100.64.1.5",
    "apiKey": "mag-…",
    "requireApiKey": true,
    "allowedHosts": ["my-mac.local"]
  },
  "contextLimits": { "softCapRatio": 0.9, "softCapMaxTokens": 200000 },
  "providers": {}
}
```

| Key | Values | Applies |
| - | - | - |
| `appearance` | `system`, `light`, `dark` | Immediately |
| `autoDownloadUpdates` | `true`, `false` | Immediately |
| `modelsDirectory` | Absolute path of the model folder. Absent means `~/.magnitude/models`. A symbolic link is followed. | Next start |
| `network.enabled` | `true` to accept connections from other devices. Absent or `false` means this computer only. | Next start |
| `network.bind` | One IP address of this computer. Absent means all interfaces. | Next start |
| `network.apiKey` | The key other devices must send. Generated when enabled through Settings. When editing this file, supply a long, randomly generated secret. | Next start |
| `network.requireApiKey` | `false` lets other devices connect without a key. Default `true`. | Next start |
| `network.allowedHosts` | Hostnames accepted in requests from other devices, in addition to IP addresses, `localhost`, `host.docker.internal`, and `.ts.net` names. | Next start |
| `contextLimits.softCapRatio` | Fraction of a model's context window used before compaction. Default `0.9`. | Next model load |
| `contextLimits.softCapMaxTokens` | Absolute cap on context tokens, or `null`. | Next model load |
| `providers` | OpenAI-compatible endpoints to expose alongside local models. Run `magnitude docs custom-endpoints` for the schema. | Immediately |

Invalid values are ignored and logged. A relative `modelsDirectory` or a `network.bind` that is not an IP address falls back to the default, and **Settings** shows the reason.

## Other files in `~/.magnitude`

| Path | Contents |
| - | - |
| `models/` | Downloaded models, unless `modelsDirectory` points elsewhere. |
| `cache/` | Cached and derived data. Safe to delete while Magnitude is not running. |
| `harness-connections.json` | Connection records for **Connections**. |

Do not delete the whole directory to fix one problem. Removing the app and removing model data are separate actions.


This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.