Конфигурация
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:
docker compose up -dЧто нужно настроить на сервере
Section titled “Что нужно настроить на сервере”Почти ничего. Календари Mitra, CalDAV, Календарь Apple, подписки на календари, Notion, Todoist и Tempo пользователи добавляют сами, прямо в приложении.
Только для двух вещей нужны учётные данные, которые сначала нужно зарегистрировать у стороннего сервиса: для Google Календаря (MITRA_GOOGLE_*) и для входа в систему (MITRA_OIDC_*).
Подключите HTTPS
Section titled “Подключите HTTPS”Как только Mitra можно открыть не только с вашего компьютера, разместите его за обратным прокси, например Caddy, Traefik или nginx, и поручите прокси работу с HTTPS. Внутри контейнера Mitra работает по обычному HTTP. Некоторые функции работают только по HTTPS:
- Браузеры разрешают напоминания и установку приложения только на адресах
https://(и наhttp://localhost). - Файлы cookie для входа в систему помечаются как защищённые только на
https://, а большинство провайдеров удостоверений требуют адрес перенаправленияhttps://. - Google Календарь требует адрес перенаправления
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», потому что они задаются при сборке приложения.
Все переменные
Section titled “Все переменные”Основные
Section titled “Основные”| Переменная | По умолчанию | Описание |
|---|---|---|
MITRA_URL | (не задано) | Публичный адрес, по которому пользователи открывают Mitra, например https://mitra.example.com. От него зависят адреса возврата для входа в систему и Google Календаря, а также то, защищены ли файлы cookie. Необязателен, пока вы пробуете Mitra на localhost, обязателен для входа в систему и рекомендуется для Google Календаря и любого публичного сервера. |
MITRA_NAME | (Mitra на языке каждого пользователя) | Название на боковой панели, во вкладке браузера и в установленном приложении. |
MITRA_PORT | 3000 | Порт, который слушает сервер. В Docker вместо этого измените порт на стороне хоста в сопоставлении портов; задавайте эту переменную, только если сам процесс должен слушать другой порт. Встроенная проверка работоспособности следует за ней. |
MITRA_LOG_LEVEL | info | Насколько подробно Mitra ведёт журнал: error, warn, info, debug или trace. Каждый уровень включает всё, что пишут менее подробные. |
MITRA_UPDATE_CHECK | (включено) | Задайте off (или false, 0, no), чтобы отключить проверку обновлений. |
MITRA_MCP | (включено) | Задайте off (или false, 0, no), чтобы закрыть адрес, к которому подключаются ИИ-инструменты. |
Напоминания
Section titled “Напоминания”| Переменная | По умолчанию | Описание |
|---|---|---|
MITRA_VAPID_SUBJECT | mailto:mitra@localhost | Контакт, который push-сервисы видят для напоминаний вашего сервера, обычно адрес mailto:. Пользователи Mitra его не видят. Ключи подписи создаются автоматически, так что больше ничего задавать не нужно. |
| Переменная | По умолчанию | Описание |
|---|---|---|
MITRA_PHOTON_URL | https://photon.komoot.io | Геокодер Photon, на котором работает поле места. Укажите свой экземпляр Photon вместо общедоступного от komoot. |
Вложения
Section titled “Вложения”| Переменная | По умолчанию | Описание |
|---|---|---|
MITRA_FILE_MAX_SIZE | 25M | Наибольший размер файла, который пользователь может прикрепить к записи, в байтах или с суффиксом k, M или G. Задайте 0, чтобы запретить добавлять файлы. |
MITRA_FILE_QUOTA | (не задано) | Сколько всего каждый пользователь может хранить во вложенных файлах; записывается так же. Если не задано, ограничения нет. |
Google Календарь
Section titled “Google Календарь”Задайте обе переменные, чтобы пользователи могли подключать Google Календарь. Если задать только ID, Mitra не запустится.
| Переменная | По умолчанию | Описание |
|---|---|---|
MITRA_GOOGLE_CLIENT_ID | (не задано) | ID клиента OAuth из консоли Google Cloud. |
MITRA_GOOGLE_CLIENT_SECRET | (не задано) | Секрет клиента OAuth. Обязателен, если задан MITRA_GOOGLE_CLIENT_ID. |
Единый вход
Section titled “Единый вход”Переменная 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_SCOPES | openid profile email | Области доступа, которые запрашивает Mitra, через пробел. openid обязательна; profile и email дают Mitra имя и адрес электронной почты каждого пользователя. |
Задаются при сборке
Section titled “Задаются при сборке”Эти переменные не нужно задавать на сервере. Их задаёт сборка или образ, либо они нужны для разработки самого Mitra.
| Переменная | Кем задаётся | Описание |
|---|---|---|
MITRA_VERSION | Сборка | Версия, встроенная в образ. |
MITRA_COMMIT | Сборка | Коммит, встроенный в образ. |
MITRA_DEV | Разработка | Предлагает интеграцию Демо, набор демонстрационных календарей, при разработке Mitra. |
NODE_ENV | Образ | production в образе контейнера. |
Пример
Section titled “Пример”Сервер со входом в систему, 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'