# Config settings (https://docs.neuralisapp.com/brain-core/config-settings)

Every tunable brain-core has is a declared platform setting, edited by the
owner in **Admin → Config** (and the embedding ones also in the admin Vector
section or during setup). Each setting shows its label, description, default
and bounds there; the manifest's `configSettings` list is the complete set.
Limits default generous. How settings are declared and resolved is on
[package-system config settings](https://docs.neuralisapp.com/package-system/config-settings.md).

## Embedding [#embedding]

| Setting | Default | Meaning |
| --- | --- | --- |
| `embeddingEnabled` | `true` | Off makes no document or query embedding calls at all; content and metadata are still indexed |
| `embeddingModelId` · `embeddingDimension` | `ollama:nomic-embed-text` · `768` | The **target** model and dimension — changing them starts nothing until a rebuild ([Sources](https://docs.neuralisapp.com/brain-core/sources.md#the-embedding-pipeline)) |
| `embeddingEndpoints` | none | Your own OpenAI-compatible embedding servers (below) |
| `ollamaUrl` · `openaiBaseUrl` · `qwenEmbeddingBaseUrl` | the providers' public URLs | Where the local and cloud providers are reached |
| `embeddingDailyUsdCap` | `0` (no cap) | Stops embedding for the rest of the UTC day once today's priced spend reaches it; indexing continues and semantic search falls back to text search with a warning |
| `vectorKeepPreviousGeneration` | `false` | Keep the old collection after a rebuild as a rollback copy, at double the storage |
| `embeddingRequestTimeoutMs` · `vectorEmbedMaxRetries` · `brainOllamaEmbedConcurrency` · `vectorOllamaKeepAlive` | — | Request timeout, retries, local concurrency, and how long Ollama keeps the model loaded |

Supported providers are Ollama (local), OpenAI, Gemini, Qwen, and Voyage. The
model list is a registry of explicit records — provider, protocol, default and
supported dimensions, credential id. Two models are **multimodal** — Gemini
Embedding 2 (images, PDF pages, audio and video) and Voyage's multimodal model
(images and PDF pages); the rest are text-only. Models that tell queries and
documents apart are told which one each call is, and many expose
**MRL (Matryoshka) selectable dimensions**: a smaller vector trades a little
quality for less storage and faster search.

Any server that speaks the OpenAI `/v1/embeddings` protocol can be added as an
**embedding endpoint**: its URL, its models with the dimension each returns
(and optionally a price), its authentication, and its address class. Its
models appear as `endpoint:<id>:<model>`, and a keyed endpoint's key is a
[credential](https://docs.neuralisapp.com/brain-core/credentials.md). An endpoint whose model is the active
one, the target, or a running rebuild's target cannot be removed, disabled or
renamed (`409 endpoint_in_use`) — switch the index away from it first. A
**public** endpoint is address-checked and IP-pinned on every call, like the
cloud providers; **private** is your explicit statement that the address is
inside your own network. The two cloud base-URL overrides accept public
addresses only — a gateway inside your network is added as a private
endpoint instead.

## Sync and watching [#sync-and-watching]

`brainAutoSyncMode` (`on`, `off`, `packages-only`) controls the background
scheduler; `brainSyncPollIntervalMs` (60 s), `brainSyncReconcileEveryMs`
(24 h), `brainSyncBootReconcile` and its delay (30 s) its cadence;
`brainSyncMaxConcurrent` (2 running jobs) and `brainSyncConcurrency` (files
in parallel inside one job) how much runs at once;
`brainSyncDebounceMs` and `brainSyncDirtyUriCap` the watcher's batching;
`brainWatchMaxFolders` (200 000 folders) and the two watch-recovery delays the OS watch;
`brainMaxScanFiles` (200 000, overridable per source) and `brainScanTimeoutMs`
the walk; `brainQdrantWatchIntervalMs` (30 s) the vector-database probe and
`brainQdrantRequestTimeoutMs` (300 s, read at start) the bound on every
vector-database request, `brainQdrantProbeTimeoutMs` (5 s, read at start) how
long that probe waits before it counts the vector database as unavailable.

## Indexing limits [#indexing-limits]

`brainSyncMaxFileMb` (5), `brainSyncMaxIndexTextChars` (200 000) and
`brainSyncMaxAppendFileMb` (20) bound what one file costs;
`brainSyncBinarySniffChars` (8 192, `0` off) skips binaries;
`brainSyncMaxMediaMb` (8) and `brainSyncMaxPdfPages` (20) bound media
embedding; `vectorChunkTargetChars`, `vectorChunkOverlapChars`,
`vectorChunkMinThresholdChars` and `vectorMaxChunksPerFile` shape chunking.

## Reading and media [#reading-and-media]

`brainMaxReadFileMb` (100) caps a read; `inlineImageMaxMb`, `inlineAudioMaxMb`,
`inlineVideoMaxMb`, `inlinePdfMaxMb` and `brainVisionBatchBudgetMb` cap what
`fs_read` hands a model as media; `fsReadPdfRender` (off) renders a PDF's first
page on read; `brainPdfTextExcerptBytes` and `brainReadSnippetChars` bound text
excerpts.

## Search and listing [#search-and-listing]

`brainSearchSemanticDefaultLimit` (10), `brainSearchFilterDefaultLimit` (50)
and `brainGrepDefaultLimit` (50) are the default result counts;
`brainGrepContextConcurrency` bounds grep context reads;
`vectorExactSearchMaxPoints` (20 000) is where semantic search switches from
an exhaustive comparison to the approximate index. `brainListDefaultLimit`
(500), `brainListSummaryBudgetChars` and the connector, git, folder-enrichment
and scoped-scroll limits bound `fs_list`; `brainCountCacheTtlMs` and
`brainAccessibleCacheTtlMs` cache counts and the visible-source set.

## Vector store and maintenance [#vector-store-and-maintenance]

`vectorGcIntervalHours` (24, `0` off) and `vectorGcRetentionHours` (24) drive
garbage collection; `vectorHealthBatchSize` the health scans;
`vectorWriteHotUriThreshold` (60 writes an hour), `vectorWriteHotUriTopN` and
`vectorWriteMonitorMaxUris` the hot-file report; `vectorDefaultSegmentNumber`,
`vectorMaxSegmentSizeKb`, `vectorMaxIndexingThreads` and
`vectorQuantizationMode` (`off`) the collection settings an owner applies from
[Vector Health](https://docs.neuralisapp.com/brain-core/app-surfaces.md#vector-health);
`vectorStoreWriteMaxRetries` and its delay the write retries.

## Review, discovery, git and debug [#review-discovery-git-and-debug]

- **Review:** `pendingPreviewMaxBytes` (262 144), `pendingJournalCacheBytes`,
  `pendingRepairBatchSize` (50) and `pendingOrphanProbeConcurrency`.
- **Source packages and discovery:** the `brainSourcePackageReconcile…` limits
  (roots, entries, concurrency) and the `brainDiscoveryInventory…` cache.
- **Git:** `brainGitBadgeTimeoutMs`, `brainGitPanelTimeoutMs`,
  `brainGitHeavyTimeoutMs`, `brainGitDiscoveryMaxDirents`,
  `brainGitDiscoveryMaxRepos` and `brainGitUntrackedCountCap` (the per-refresh
  budget for counting new files' lines).
- **Debug:** `brainDebug` and `brainVectorLogConsole`.
