Перейти к содержимому

Администрирование12 нояб. 2026 г.5 минут чтения

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

Mitra настраивается только через переменные окружения. Файла конфигурации, который нужно монтировать, нет: вы задаёте переменные для контейнера, и Mitra считывает их при запуске. Все переменные необязательны, а для незаданной используется значение по умолчанию из списка ниже.

В Docker Compose они указываются в блоке environment:

services:
mitra:
image: ghcr.io/a11delavar/mitra:latest
environment:
MITRA_URL: 'https://mitra.example.com'
MITRA_NAME: 'Family Calendar'

Файл .env или секреты Docker подойдут ничуть не хуже, если вы не хотите хранить секреты в файле compose. Изменения вступают в силу при следующем запуске Mitra:

Terminal window
docker compose up -d

Что нужно настроить на сервере

Section titled “Что нужно настроить на сервере”

Почти ничего. Календари Mitra, CalDAV, Календарь Apple, подписки на календари, Notion, Todoist и Tempo пользователи добавляют сами, прямо в приложении.

Только для двух вещей нужны учётные данные, которые сначала нужно зарегистрировать у стороннего сервиса: для Google Календаря (MITRA_GOOGLE_*) и для входа в систему (MITRA_OIDC_*).

Как только Mitra можно открыть не только с вашего компьютера, разместите его за обратным прокси, например Caddy, Traefik или nginx, и поручите прокси работу с HTTPS. Внутри контейнера Mitra работает по обычному HTTP. Некоторые функции работают только по HTTPS:

Затем укажите в MITRA_URL публичный адрес.

С Caddy для этого достаточно следующего:

mitra.example.com {
reverse_proxy localhost:3000
}

С Traefik направьте запросы в Mitra с помощью меток сервиса:

services:
mitra:
image: ghcr.io/a11delavar/mitra:latest
restart: unless-stopped
volumes:
- ~/mitra:/app/data
labels:
- "traefik.enable=true"
- "traefik.http.routers.mitra.rule=Host(`mitra.example.com`)"
- "traefik.http.services.mitra.loadbalancer.server.port=3000"
environment:
MITRA_URL: 'https://mitra.example.com'

Укажите публичный адрес

Section titled “Укажите публичный адрес”

MITRA_URL означает адрес, который пользователи вводят в браузере, чтобы открыть Mitra, а не внутренний адрес контейнера:

environment:
MITRA_URL: 'https://mitra.example.com'

По нему Mitra строит адреса возврата для Google Календаря и входа в систему, а если он начинается с https://, помечает файлы cookie как защищённые. Пока вы пробуете Mitra на http://localhost, переменную можно не задавать. Задайте её, как только у Mitra появится настоящий адрес; для включения входа в систему она обязательна.

Назовите свой экземпляр

Section titled “Назовите свой экземпляр”

MITRA_NAME заменяет «Mitra» на боковой панели, во вкладке браузера и в установленном приложении:

environment:
MITRA_NAME: 'Family Calendar'

Если нажать на название, откроется окно О приложении с версией и коммитом, которые у вас запущены. Установленное приложение сохраняет название и значок «Mitra», потому что они задаются при сборке приложения.

ПеременнаяПо умолчаниюОписание
MITRA_URL(не задано)Публичный адрес, по которому пользователи открывают Mitra, например https://mitra.example.com. От него зависят адреса возврата для входа в систему и Google Календаря, а также то, защищены ли файлы cookie. Необязателен, пока вы пробуете Mitra на localhost, обязателен для входа в систему и рекомендуется для Google Календаря и любого публичного сервера.
MITRA_NAME(Mitra на языке каждого пользователя)Название на боковой панели, во вкладке браузера и в установленном приложении.
MITRA_PORT3000Порт, который слушает сервер. В Docker вместо этого измените порт на стороне хоста в сопоставлении портов; задавайте эту переменную, только если сам процесс должен слушать другой порт. Встроенная проверка работоспособности следует за ней.
MITRA_LOG_LEVELinfoНасколько подробно Mitra ведёт журнал: error, warn, info, debug или trace. Каждый уровень включает всё, что пишут менее подробные.
MITRA_UPDATE_CHECK(включено)Задайте off (или false, 0, no), чтобы отключить проверку обновлений.
MITRA_MCP(включено)Задайте off (или false, 0, no), чтобы закрыть адрес, к которому подключаются ИИ-инструменты.
ПеременнаяПо умолчаниюОписание
MITRA_VAPID_SUBJECTmailto:mitra@localhostКонтакт, который push-сервисы видят для напоминаний вашего сервера, обычно адрес mailto:. Пользователи Mitra его не видят. Ключи подписи создаются автоматически, так что больше ничего задавать не нужно.
ПеременнаяПо умолчаниюОписание
MITRA_PHOTON_URLhttps://photon.komoot.ioГеокодер Photon, на котором работает поле места. Укажите свой экземпляр Photon вместо общедоступного от komoot.
ПеременнаяПо умолчаниюОписание
MITRA_FILE_MAX_SIZE25MНаибольший размер файла, который пользователь может прикрепить к записи, в байтах или с суффиксом k, M или G. Задайте 0, чтобы запретить добавлять файлы.
MITRA_FILE_QUOTA(не задано)Сколько всего каждый пользователь может хранить во вложенных файлах; записывается так же. Если не задано, ограничения нет.

Задайте обе переменные, чтобы пользователи могли подключать Google Календарь. Если задать только ID, Mitra не запустится.

ПеременнаяПо умолчаниюОписание
MITRA_GOOGLE_CLIENT_ID(не задано)ID клиента OAuth из консоли Google Cloud.
MITRA_GOOGLE_CLIENT_SECRET(не задано)Секрет клиента OAuth. Обязателен, если задан MITRA_GOOGLE_CLIENT_ID.

Переменная MITRA_OIDC_ISSUER включает вход в систему. Если нужных ей переменных нет, Mitra не запускается.

ПеременнаяПо умолчаниюОписание
MITRA_OIDC_ISSUER(не задано)URL издателя (issuer) вашего провайдера OIDC. Требует MITRA_OIDC_CLIENT_ID и MITRA_URL.
MITRA_OIDC_CLIENT_ID(не задано)ID клиента, зарегистрированного у провайдера.
MITRA_OIDC_CLIENT_SECRET(не задано)Секрет клиента. Не задавайте его для публичного клиента; Mitra всегда использует PKCE.
MITRA_OIDC_SCOPESopenid profile emailОбласти доступа, которые запрашивает Mitra, через пробел. openid обязательна; profile и email дают Mitra имя и адрес электронной почты каждого пользователя.

Эти переменные не нужно задавать на сервере. Их задаёт сборка или образ, либо они нужны для разработки самого Mitra.

ПеременнаяКем задаётсяОписание
MITRA_VERSIONСборкаВерсия, встроенная в образ.
MITRA_COMMITСборкаКоммит, встроенный в образ.
MITRA_DEVРазработкаПредлагает интеграцию Демо, набор демонстрационных календарей, при разработке Mitra.
NODE_ENVОбразproduction в образе контейнера.

Сервер со входом в систему, Google Календарём и собственным геокодером:

services:
mitra:
image: ghcr.io/a11delavar/mitra:latest
restart: unless-stopped
ports:
- '3000:3000'
volumes:
- ~/mitra:/app/data
environment:
MITRA_URL: 'https://mitra.example.com'
MITRA_NAME: 'Family Calendar'
# Sign-in
MITRA_OIDC_ISSUER: 'https://auth.example.com'
MITRA_OIDC_CLIENT_ID: 'mitra'
MITRA_OIDC_CLIENT_SECRET: '…'
# Google Calendar
MITRA_GOOGLE_CLIENT_ID: '….apps.googleusercontent.com'
MITRA_GOOGLE_CLIENT_SECRET: '…'
# Your own geocoder
MITRA_PHOTON_URL: 'https://photon.internal.example.com'