---
title: "Конфигурация"
description: "Негізгі орта айнымалыларына шолу: порт, аутентификация режимі, қызметтік дерекқор, кеңістіктер топологиясы, іздеу."
---

# Конфигурация

Notarium **орта айнымалылары** арқылы бапталады — образға ешқандай құпия немесе жол жазылмайды. Әдепкі мәндер zero-config үшін ойластырылған: таза дана бірде-бір баптаусыз көтеріледі. Бұл бет — негізгі айнымалыларға шолу; нақты мәндер мен әдепкілері бар толық тізім [Анықтамалықта](/docs/reference/environment-variables/).

Конфигурация `docker run` пәрменінің `-e` жалаушаларымен немесе `.env` файлымен беріледі (ол `.env.example` файлынан көшіріледі). Docker-стек `.env` файлын контейнерге сол күйінде береді.

## Негізгі айнымалылар

| Айнымалы | Мақсаты | Әдепкі |
|---|---|---|
| `DATA_DIR` | Деректердің жалғыз тұтқасы: қалғанының бәрі — қызметтік дерекқор, индекстер, жазбалар, артефактілер — осы түбірден шығарылады. Берілмесе → жұмысқа жарамды әдепкі мән алынады. | `/data` (Docker); `~/.local/share/notarium` (host) |
| `PORT` | Бэкенд тыңдайтын порт (`/api`, `/mcp` және веб-интерфейс). | `3000` |
| `AUTH_MODE` | Аутентификация режимі: `password` немесе `none`. | `password` |
| `META_DB_URL` | Қызметтік дерекқор: `sqlite:<path>` немесе `postgres://…`. Міндетті емес — тек сыртқы Postgres үшін беріледі; әдепкіде бұл `DATA_DIR` астындағы SQLite. | `sqlite:<DATA_DIR>/meta.db` |
| `SPACES_ROOT` | Әр кеңістік бір қалта болатын түбір; интерфейстен кеңістік құруды қосады. Міндетті емес — тек жазбалар `DATA_DIR`-дан тыс жатса. | `<DATA_DIR>/spaces` |
| `VECTOR_SEARCH` | `on`/`off` — семантикалық (векторлық) іздеу. | жарияланған образда `off` (кодта — `on`) |

Әр тақырып өз бетінде ашылған: [Аутентификация](/docs/self-hosting/authentication/) (`AUTH_MODE`), [Дерекқор](/docs/self-hosting/database/) (`META_DB_URL`), [Семантикалық іздеу](/docs/self-hosting/search-setup/) (`VECTOR_SEARCH` және модель параметрлері).

## Кеңістіктер топологиясы

Кеңістіктерді (space) анықтаудың екі жолы бар:

- **`SPACES_ROOT`** — zero-config: әр кеңістік — көрсетілген түбір астындағы қалта. Кеңістіктер алғашқы іске қосуда және интерфейстегі «New space…» түймесімен құрылады. Бұл — Docker-стектің әдепкісі.
- **`SPACES_CONFIG`** — айқын, бекітілген топология (inline-JSON немесе JSON-файлға жол). Кеңістіктер жиынтығын оператор анықтайтын әрі ол интерфейстен құрылмайтын жағдайға қолайлы.

Кеңістіктер мен жобалардың моделі туралы — [Тұжырымдамалар](/docs/concepts/spaces-and-projects/) бөлімінде.

## Агенттердің аутентификациясы (OAuth)

Жеке токендерден (PAT) бөлек, Notarium MCP-коннекторларды **OAuth** арқылы авторизациялай алады — сонда агент (мысалы, Claude коннекторы) токенді қолмен енгізбей-ақ өзі авторизациядан өтеді. Мұны бөлек баптаудың қажеті жоқ: клиенттер динамикалық тіркеледі. Кері прокси артында `PUBLIC_BASE_URL` орнатыңыз (мысалы, `https://notes.example.com`) — OAuth-метадеректері үшін тұрақты сыртқы мекенжай; онсыз мекенжай проксидің forwarded-тақырыптарынан шығарылады. Сол прокси артында `TRUST_PROXY`-ді де беріп қойған жөн: кіру әрекеттері мен жаңа коннекторларды қабылдау лимиттері проксидің мекенжайымен емес, клиенттің нақты IP-мекенжайымен есептелсін — [Өнімдік орта](/docs/self-hosting/production/) бетін қараңыз. Агенттерді қосу туралы толығырақ — [Агентті қосу](/docs/agents/connect/).

> [!tip] Толық анықтамалық
> Іздеу айнымалылары (`EMBED_MODEL`, `EMBED_DIMENSIONS`, `EMBED_CPU_MEM_ARENA` және т.б.), синхрондау таймингтері мен басқа да нәзік тұтқалар [Орта айнымалылары](/docs/reference/environment-variables/) бетіндегі кестелерге жинақталған.

Ары қарай: [аутентификацияны](/docs/self-hosting/authentication/) және қажет болса, [семантикалық іздеуді](/docs/self-hosting/search-setup/) баптаңыз.