Установка KITMS

Как установить KITMS на Ubuntu без ручной сборки почтового стека

KITMS устанавливается не через набор разрозненных действий в консоли, а по понятному сценарию с проверками и мастером установки. Для оператора это означает предсказуемый маршрут: подготовить сервер, пройти шаги мастера, дождаться начальной настройки, получить уникальный идентификатор и перейти к активации лицензии.

Базовые требования к серверу

• Ubuntu 22.04 или Ubuntu 24.04.
• Доступ по SSH под root или под пользователем с sudo.
• Исходящий доступ сервера к www.kitms.ru и download.kitms.ru.
• Минимум 2 GB RAM и не менее 10 GB свободного места.
• Готовность открыть рабочие порты почтового контура после завершения install flow.

Быстрый запуск

Если сервер чистый и вы готовы проходить мастер установки прямо в терминале, базовый старт выглядит так:

curl -fsSL https://www.kitms.ru/install/install_kitms.sh | sudo bash

Bootstrap скачает актуальный внутренний installer, проверит release metadata и затем передаст управление основному сценарию установки.

Что вы увидите в мастере установки

В интерактивном режиме мастер KITMS собирает конкретный набор параметров. Ниже перечислены реальные шаги и то, что нужно вводить на каждом из них.

1. Language
   Выберите язык мастера: ru или en. Для русскоязычного запуска оставляйте ru.
2. Primary domain
   Введите основной почтовый домен компании, например company.ru. Именно к нему будет привязываться первый администратор и дочерние hostname.
3. Mail hostname
   Введите основной mail FQDN, обычно это mail.company.ru. Этот hostname должен принадлежать выбранному основному домену.
4. Panel hostname
   Введите hostname панели. Если отдельный адрес панели не нужен, оставляйте тот же hostname, что и для mail, например mail.company.ru.
5. Webmail hostname
   Введите отдельный hostname для webmail, например webmail.company.ru. Он должен отличаться от mail hostname.
6. Timezone
   Введите IANA timezone сервера, например Europe/Kaliningrad, Europe/Moscow или UTC.
7. Mailbox mode
   Выберите режим хранения почтовых ящиков: path или disk. Если отдельного пустого диска под mailstore нет, выбирайте path.
8. Mailbox root или Mailbox disk
   Если выбран режим path, укажите логический путь для ящиков, обычно оставляют системный default. Если выбран режим disk, мастер попросит выбрать пустой диск вида /dev/sdb.
9. Disk mount
   Появляется только в режиме disk. Здесь указывается точка монтирования почтового диска, например /mnt/kitms-mailstore. Дальше мастер автоматически размещает под ней каталог ящиков.
10. First admin email
    Введите email первого администратора внутри основного домена, например admin@company.ru. Валидация не пропустит адрес вне основного домена.
11. First admin name
    Введите отображаемое имя первого администратора, например Администратор почты или KITMS Administrator.
12. First admin password
    Задайте пароль для первого почтового администратора. Мастер просит подтверждение значения дважды.
13. Linux admin mode
    Выберите create или existing. Если выделенного Linux-админа еще нет, обычно выбирают create.
14. Linux admin login
    Если выбран режим create, задайте логин нового Linux-админа, например kitmsadmin. Если выбран existing, укажите существующий sudo/admin login на сервере.
15. Linux admin password
    Введите пароль Linux-админа. Этот пользователь нужен для terminal/server-функций внутри KITMS, поэтому здесь не стоит использовать временный или слабый пароль.

Отдельно про режим хранения ящиков

• Режим path подходит, если ящики можно хранить на основном диске сервера.
• Режим disk нужен, если под mailstore выделяется отдельный пустой диск.
• При выборе disk мастер может автоматически подготовить выбранное устройство, но все данные на нем будут стерты.
• В этом сценарии оператор должен осознанно подтвердить очистку диска, введя вручную ERASE.

Что происходит после ввода параметров

• Installer валидирует введенные значения: домен, hostname, timezone, email первого администратора, Linux login и выбранную схему хранения ящиков.
• После подтверждения начинается preflight и основной сценарий установки: пакетный стек, KITMS runtime, webmail, pgAdmin, Linux admin, сервисы и smoke-проверки.
• По завершении выводится install summary с hostname, первым администратором, Linux admin login и fingerprint для активации.

Что делать после завершения install flow

• Откройте страницу активации KITMS на установленном узле.
• Скопируйте fingerprint сервера.
• Получите подписанный license.json через licensing contour KITMS.
• Примените лицензию и переходите к настройке доменов, ящиков, DNS, сертификатов и обновлений уже из интерфейса продукта.

Практический совет перед запуском

Если сервер готовится под новый контур впервые, не начинайте с экспериментального ручного тюнинга системы. Проще и безопаснее заранее определить домен, hostname, timezone, схему хранения ящиков и Linux admin account, а затем пройти install flow последовательно. Так вы не создадите лишний дрейф между сервером и ожидаемой конфигурацией KITMS.