mailer для vikunja

mailer для vikunja

В дополнение к статье о настройке vikunja (https://freeserver.su/it/proekt-menedzher-vikunja.html) накатал небольшую статью по настройке майлера.
И несколько примеров для разных почтовиков.

Погнали.

Чтобы добавить блок mailer в Vikunja (для отправки писем — подтверждение регистрации, сброс пароля, напоминания о задачах и т.д.), откройте ваш файл конфигурации:

sudo nano /etc/vikunja/config.yml

и добавьте (или измените) секцию mailer: примерно так:

mailer:
  enabled: true                     # обязательно true, иначе почта не будет работать вообще
  host: smtp.gmail.com              # адрес SMTP-сервера вашего почтового провайдера
  port: 587                         # чаще всего 587 (STARTTLS) или 465 (SSL/TLS)
  authtype: plain                   # обычно plain или login
  username: your.email@gmail.com    # логин (полный email)
  password: "your-app-password"     # пароль приложения (не обычный пароль!)
  fromemail: "Vikunja <your.email@gmail.com>"   # от кого будут приходить письма
  skiptlsverify: false              # true только если самоподписанный сертификат и не жалко безопасность
  force SSL: false                  # true если порт 465 и нужен принудительный SSL (обычно не нужно)

Самые популярные примеры готовых блоков mailer

1. Gmail (самый частый вариант в 2025–2026 году)
Сначала создайте пароль приложения в Google:

https://myaccount.google.com/apppasswords
Выберите «Почта» → «Другое (название по желанию)» → сгенерируйте 16-символьный пароль

mailer:
  enabled: true
  host: smtp.gmail.com
  port: 587
  authtype: plain
  username: yourname@gmail.com
  password: abcd efgh ijkl mnop     # ← 16 символов без пробелов!
  fromemail: "Vikunja Tasks <yourname@gmail.com>"
  skiptlsverify: false
  force SSL: false

2. ProtonMail / Proton (через proton bridge обычно)
Обычно используется локальный bridge (127.0.0.1:1025 или 587)

mailer:
  enabled: true
  host: 127.0.0.1
  port: 1025                        # или 587 — зависит от настроек bridge
  authtype: plain
  username: your@proton.me
  password: ваш_пароль_от_bridge
  fromemail: "your@proton.me"
  skiptlsverify: true               # почти всегда true для bridge
  force SSL: false

3. Yandex.Mail / Mail.ru (российские сервисы)

mailer:
  enabled: true
  host: smtp.yandex.ru              # или smtp.mail.ru
  port: 465
  authtype: plain
  username: login@yandex.ru
  password: ваш_пароль_приложения
  fromemail: "Vikunja <login@yandex.ru>"
  skiptlsverify: false
  force SSL: true                   # для 465 обычно true

4. SendGrid / Mailgun / SMTP2GO и другие transactional-сервисы

mailer:
  enabled: true
  host: smtp.sendgrid.net
  port: 587
  authtype: plain
  username: apikey                  # ← буквально слово "apikey"
  password: SG.XXXXXXXXXXXXXXXXXXXX  # ваш API-ключ
  fromemail: "no-reply@yourdomain.com"

После изменения конфига — обязательные действия:

1. Перезапустите Vikunja:

sudo systemctl restart vikunja

2. Проверьте логи на ошибки:

journalctl -u vikunja -e -n 150

Ищите строки с mailer, smtp, email, dial, EOF, 535, auth.

3. Зайдите в Vikunja → настройки пользователя → попробуйте «Отправить тестовое письмо» (Test mail) — эта кнопка есть в последних версиях.

4. Если ничего не отправляется — проверьте:
- Правильно ли указан fromemail (многие SMTP-серверы требуют точного совпадения)
- Включена ли двухфакторка и создан ли app-password
- Не блокирует ли провайдер SMTP с вашего IP (часто бывает у новых серверов)

Upd.

Сменить пароль пользователя в консоли можно так:

sudo vikunja user reset-password [b]SOME_USER[/b] -d -p [b]PASSWORD[/b]

Полезно, если на сервере нет почтовика. Или хочется "по-быстрее" ;)