Kimai

Kimai связывает запись времени с клиентом, проектом и видом работы. Исполнитель запускает таймер или вносит часы вручную, а руководитель видит, на что ушло время. Ставку можно назначить для оплачиваемой работы и собрать счет из выбранных записей.

На стенде мы создали клиента и проект, внесли 1:30 работы и указали ставку 1500 ₽ в час. В разделе счетов Kimai рассчитал 2250 ₽ и сохранил счет с номером 2026/001. Это проверенный путь в веб-интерфейсе, а не описание возможностей по README.

После сохранения счета запись остается в истории с номером и статусом. Это помогает отделить подготовку документов от ведения времени, но не превращает Kimai в бухгалтерскую систему. Проверять реквизиты и правила учета придется вне этого теста.

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

У самостоятельной установки нет платы за каждое место в самом открытом коде. Вместо подписки команда оплачивает сервер и берет на себя обновления, мониторинг, резервные копии и восстановление. Отдельные плагины Kimai продаются платно.

В облачных тарифах цена зависит от активных участников, а набор функций различается. У самостоятельного Kimai цена железа не растет строго по числу пользователей, зато появляется постоянная эксплуатационная работа. Эти модели нельзя сравнивать только одной строкой в прайсе.

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

Наш Compose-проект содержит официальный образ kimai/kimai2:2.67.0, MySQL 8.4.11 и Caddy 2.10.2. Приложение и база общаются во внутренней сети Docker. Наружу через HTTPS смотрит только обратный прокси; порт Kimai привязан к localhost.

MySQL хранит клиентов, проекты, пользователей, ставки, записи времени и историю счетов. Отдельные тома Compose отведены под данные Kimai и плагины. Сертификаты Caddy лежат в своих томах. При переносе важны база и прикладные тома, а не только контейнеры.

Валюта в проверенном примере задана клиенту, а ставка введена в запись времени. Kimai объединил их при расчете счета. У проекта могут быть и другие ставки и правила округления; на стенде мы их не сравнивали.

Для почты образ поддерживает MAILER_URL и MAILER_FROM. Без рабочего SMTP ссылка «Я забыл пароль» не завершит восстановление доступа. На стенде тестовое письмо через STARTTLS дошло до ящика; полный сброс пароля мы не проводили. Настройка почты описана апстримом.

Апстрим не дает численного минимума памяти для нашего трехконтейнерного состава. Поэтому отправной точкой служит замер на VM с 2 vCPU, 4 ГБ RAM и диском 50 ГБ. Для проверенного сценария выбираем фиксированный CPU2-RAM4-DISK50.

Показатель free -m включает память всей VM, а docker stats измеряет отдельные контейнеры. Складывать эти числа как независимые расходы нельзя: часть памяти относится к системным процессам и файловому кешу.

На чистую Ubuntu 24.04 поставили Docker Engine и Compose из официального apt-репозитория Docker. Скрипт создал случайные пароли базы и администратора, секрет приложения и файл доступов с закрытыми правами. Затем поднял MySQL, Kimai и Caddy.

1. Выбрать постоянные данные

   Сохранить Compose-файл и секреты в закрытом каталоге. База, данные приложения и плагины должны жить в томах, переживающих пересоздание контейнеров.

2. Закрепить версии

   В стенде использованы конкретные теги трех образов, а не latest. Для обновления сначала проверьте совместимость Kimai и базы, затем сделайте копию.

3. Поднять сервисы

   Compose ждет здоровую базу, затем запускает приложение. Caddy выпускает сертификат для публичного домена; приложение остается на 127.0.0.1:8001.

4. Проверить пользовательский путь

   Недостаточно ответа главной страницы: мы вошли в браузере, сохранили время, ставку и счет. После пересоздания контейнера Kimai данные остались в интерфейсе.

sudo docker compose -f /opt/kimai/compose.yml pull
sudo docker compose -f /opt/kimai/compose.yml up -d
sudo docker compose -f /opt/kimai/compose.yml ps

Повторный запуск скрипта не перезаписывает уже созданные пароли. После изменения Caddyfile он явно перечитывает конфигурацию прокси; один docker compose up -d не применил бы изменение смонтированного файла к уже работающему Caddy.

Текущая документация Compose и README расходятся по примеру версии MySQL: в образце встречается 8.3, тогда как релиз требует 8.4+. Стенд с MySQL 8.4.11 прошел миграции и сохранил счет.

У MySQL и Kimai статус healthy, Caddy работает. Пять последовательных запросов с машины конвейера к публичной странице входа дали HTTP 200 и проверенный TLS. Медиана полного ответа с редиректами составила 0.114 с.

Время первого скачивания образов, первого ответа и полного сетапа при первоначальной установке не засекалось. Поздний повтор использовал уже скачанные образы, поэтому его продолжительность нельзя выдавать за время чистого заказа. Эти интервалы оставлены без цифр.

Снимки сделаны браузером с машины конвейера через тот же публичный адрес, которым пользуется клиент. Поэтому проверка включала авторизацию, cookie, прокси и сертификат. Локальный ответ контейнера сам по себе не дал бы такой проверки.

При создании счета шаблон оказался обязательным. Мы выбрали клиента, создали шаблон, назначили записи времени ставку 1500 ₽/час и получили счет на 2250 ₽. История сохранила номер 2026/001 и статус «Новый». Содержимое скачиваемого документа не проверяли.

Проверено 4 октября 2026 на Kimai 2.67.0 в dev-контуре stand-1. Клиентский заказ в prod-контуре проверяется отдельно.

При первом запуске Kimai выполнил миграции, но его проверка здоровья и локальный запрос отвечали HTTP 400. В TRUSTED_HOSTS был только внешний домен: запрос к localhost сервер счел недоверенным. Это ошибка конфигурации, которую легко принять за недоступность приложения.

В форме времени выбор проекта обновляет список видов работ. Если активность выбрана раньше проекта, она сбрасывается; первый тест вернулся с «Необходимо выбрать активность». Правильный порядок - проект, обновленный список активности, затем сохранение.

Создайте отдельные учетные записи для сотрудников и ограничьте права ролями. Административный пароль и APP_SECRET должны быть уникальными. Файл /opt/kimai/.env на стенде доступен только root; туда же попадают реквизиты SMTP, если включена почта.

Снаружи нужны только 80 и 443 для Caddy и выпуска сертификата. Порт Kimai слушает localhost, MySQL в публичную сеть не выставлен. Внешний доступ к базе лучше открывать отдельно и только под конкретный сценарий, а не как часть типовой установки.

Перед обновлением делайте согласованную копию MySQL и томов Kimai. Команда docker compose down -v удаляет тома и здесь опасна. Восстановление из копии на отдельной машине мы не проверяли, поэтому наличие файлов не следует путать с доказанной процедурой восстановления.

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

Обновление - это новая пара совместимых версий приложения и БД, а не слепой переход на latest. После смены тегов повторите вход и путь от записи времени до счета. Релизы Kimai и инструкция по Compose служат точками сверки.

Redmine подойдет, если команде нужен подробный жизненный цикл задач, а Kimai отвечает за оплачиваемые часы и выставление счета. Связь между ними не настраивалась на стенде; здесь речь о разделении ролей продуктов, не о готовой интеграции.

Caddy закрывает публичный HTTPS и остается в составе рецепта. Для почты понадобится ваш SMTP-сервис. Отчеты Kimai открываются в интерфейсе, а регулярные выгрузки и бухгалтерскую интеграцию следует оценивать на собственных данных и требуемых форматах.

AGPL-3.0 позволяет самостоятельную установку открытого ядра, но условия лицензии для модифицированного сервиса и состав платных плагинов нужно разбирать отдельно. Особенно если вы планируете дорабатывать Kimai и давать доступ сторонним клиентам.