Инструкция

1. Создайте резервную копию базы данных:

cd /root/swarmica

# Полный логический дамп всех баз и ролей внутри контейнера
docker exec -it --env-file .env swarmica-postgres sh -c 'pg_dumpall -U $POSTGRES_USER > /backups/full_backup_pg14.sql'

# Копируем дамп на хост
docker cp swarmica-postgres:/backups/full_backup_pg14.sql /root/swarmica/

Проверьте резервную копию:

ls -lh /root/swarmica/full_backup_pg14.sql
grep -c "CREATE DATABASE" /root/swarmica/full_backup_pg14.sql

Если вторая команда вернула ≥ 1 — дамп содержит базы данных, всё в порядке.

2. Остановите сервисы Swarmica:

cd /root/swarmica
docker compose down

3. Удалите старый том данных:

PostgreSQL 18 не сможет запуститься на томе, инициализированном версией 14, — контейнер упадёт с ошибкой о несовместимости. Поэтому том надо удалить и создать заново.

docker volume rm swarmica_swarmica_postgres_data

4. Создайте новый пустой том:

docker volume create swarmica_swarmica_postgres_data

5. Отредактируйте docker-compose.yml. Откройте файл в текстовом редакторе и измените image и volume в сервисе postgres как показано ниже:

<...>
postgres:
  image: postgres:18-bookworm                          # ← ИЗМЕНЕНО: было postgres:14.2-bullseye
  container_name: swarmica-postgres
  shm_size: 1gb
  command: postgres -N 200 -c work_mem=8MB -c temp_buffers=16MB -c shared_buffers=1GB -c track_activity_query_size=16384
  healthcheck:
    test: ["CMD-SHELL", "pg_isready -U ${POSTGRES_USER} -d ${POSTGRES_DB}"]
    interval: 10s
    timeout: 5s
    retries: 5
    start_period: 10s
  restart: always
  volumes:
    - swarmica_postgres_data:/var/lib/postgresql:z     # ← ИЗМЕНЕНО: было /var/lib/postgresql/data
<...>

6. Запустите только PostgreSQL 18:

docker compose up -d postgres

Дождитесь статуса healthy:

docker compose ps
docker compose logs postgres | tail -20

В логах должно быть database system is ready to accept connections. Это значит, что initdb создал новый кластер PostgreSQL 18 в свежем томе.

7. Скопируйте резервную копию БД из шага 1 внутрь контейнера:

docker cp /root/swarmica/full_backup_pg14.sql swarmica-postgres:/tmp/full_backup_pg14.sql
docker exec -it swarmica-postgres ls -lh /tmp/full_backup_pg14.sql

8. Восстановите данные из резервной копии:

docker exec -it swarmica-postgres sh -c 'psql -U $POSTGRES_USER -d postgres < /tmp/full_backup_pg14.sql'

9. Запустите остальные сервисы Swarmica:

cd /root/swarmica
docker compose up -d

10. Выполните завершающие процедуры:

docker exec --env-file .env -it swarmica-django-1 python manage.py post_start

11. Удалите временный дамп из контейнера:

docker exec -it swarmica-postgres rm /tmp/full_backup_pg14.sql

Дамп на хосте (/root/swarmica/full_backup_pg14.sql) оставьте на несколько дней как страховку. Удаляйте только после полной уверенности в стабильности.

Симптомы

Автоматическое обновление падает с ошибкой:

make upgrade:
..
FAIL  Services are not running and healthy:
  celerybeat: unhealthy
  celeryworker: unhealthy

Решение

1. Для указанных контейнеров (в примере это celerybeat и celeryworker) настроить healthcheck как указано в статье.
2. Рестартануть контейнеры:

   docker compose down && docker compose up -d
   

3. Продолжить процесс обновления Свормики.

Причина

Неправильные настройки healthcheck в docker-compose.yml

Инструкция

Обновление

Начиная с v6.0.x обновление выполняется с помощью механизма автообновления. Промежуточные версии можно не устанавливать: план обновления строится до последнего релиза автоматически.

Выполните в каталоге установки Swarmica:

cd /root/swarmica
make upgrade-plan    # показать план обновления, ничего не меняя
make upgrade         # выполнить обновление

Если вы ещё не перешли на автообновление, выполните шаги из раздела Переход на автообновление в инструкции по установке обновлений.

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

docker system prune -a

✨ Основные улучшения

🤖 ИИ-агенты

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

• ⚖️ Обработка апелляций по качеству сервиса (QA), качеству контента (AQI) и точности связанности (LAI) — ИИ-агент анализирует возражения оцениваемых сотрудников, при обоснованных доводах корректирует оценку, а в остальных случаях даёт развёрнутое объяснение и подводит итог рассмотрения в общем комментарии
• ✍️ Редактор статей — приводит проверенные статьи к контент-стандарту и стилю компании: исправляет грамматику, стандартизирует оформление и публикует готовые статьи
• 🔎 SEO/GEO/AEO-оптимизация статей — заполняет мета-теги и разметку JSON-LD опубликованных статей, чтобы поисковики и нейросети корректно ранжировали базу знаний
• 🌐 Переводчик статей — переводит опубликованные статьи, у которых есть только одна локаль, с сохранением форматирования
• 🎛️ Обновлённый диалог выбора компетенции при создании ИИ-агента и быстрый поиск по компетенциям
• 🔄 Статус ИИ-агента и ход выполнения его задач обновляются в интерфейсе в реальном времени, а статусы запусков выделены цветом
• 💰 Существенно снижен расход токенов при работе ИИ-агентов через YandexGPT — стоимость запусков стала сопоставимой с ChatGPT
• 🧠 Улучшен промпт ИИ-агента по умолчанию: ответы опираются только на предоставленные материалы
• 🇬🇧 Встроенные промпты и инструкции ИИ-функций на новых установках поставляются на английском языке, что снижает расход токенов; на уже работающих системах промпты не меняются

📚 Хелпцентр и SEO

• 🏷️ Поля JSON-LD (разметка schema.org) и произвольный HTML для <head> во вкладке SEO статьи — данные автоматически выводятся на страницах хелпцентра и помогают статьям подниматься выше в поисковой выдаче и ответах нейросетей
• 🤖 Страницы статей подсказывают LLM-ботам Markdown-версию статьи, а при включённом фича-флаге __llmstxt — ссылку на llms.txt
• 📄 Файл /llms-full.txt с публичными статьями базы знаний для LLM; число статей в /llms.txt и /llms-full.txt задаётся переменной NEXT_PUBLIC_LLMSFULL_MAX_ARTICLE
• ⚡ Ускорено открытие категорий базы знаний

💬 Чаты и чат-виджет

• 🔑 Регистрация и сброс пароля в чат-виджете (для авторизации по email) с поддержкой политики паролей и лицензионного соглашения — пользователи, чьи аккаунты были созданы автоматически, теперь могут обратиться в поддержку через виджет. В письма о регистрации добавлен код для ручного ввода
• 🔀 Кнопка «Ответ + статус» в чатах, как в заявках
• 📝 Черновик сообщения сохраняется при переключении между чатами — удобно, когда агент ведёт несколько диалогов одновременно
• 🖼️ Превью изображений и файлов при написании сообщения в виджете и поддержка изображений внутри сообщений чата
• ⚡ Ускорена загрузка списка чатов и сообщений
• 👥 Чаты автоматически назначаются и на агентов в статусе «В чате»: сначала на агентов «Онлайн», затем с учётом загрузки на остальных

🖥️ Улучшения UI/UX

• 🔗 При создании заявки по ссылке с параметрами можно передать значение $null, чтобы очистить поле формы (например, копию CC) — это исключает подстановку данных из предыдущей заявки и отправку писем на неверные адреса при массовом создании заявок из личного кабинета
• ⏸️ В быстром выборе срока отложенного статуса появились варианты на 15 и 30 минут
• ⚠️ При смене продукта в массовом редактировании заявок показывается предупреждение о том, что зависимые поля будут сброшены
• 💬 Счётчик общих комментариев к оценке качества — сразу видно, есть ли комментарии, без раскрытия блока
• ⚠️ Понятные сообщения об ошибках при загрузке файлов в форме создания заявки и при превышении лимита запросов
• 🔔 Предупреждение о новых изменениях в статье появляется сразу, без перезагрузки страницы
• 📜 Кнопка «Показать ещё» в выпадающих списках с поиском (категории, группы, организации, пользователи, навыки, лицензии и др.)
• 🧹 Из условий автоназначения убран «Статус пользователя» — статусы теперь напрямую управляют автоназначением
• 🖼️ При загрузке фавикона, логотипа и спиннера доступны только поддерживаемые форматы файлов

⚙️ Производительность и обслуживание

• 🔄 Автоматическое обновление командами make upgrade-plan и make upgrade
• 🐧 Поддержка Ubuntu 26.04 LTS и AltLinux 11
• 🩺 Улучшена проверка работоспособности сервисов Docker
• 🏷️ Команда python manage.py show_version для просмотра текущей версии Swarmica

🐞 Исправления

• 💬 Чаты: восстановлены автоматические статусы «В чате» и «Завершение чата», исправлены дублирование и пропадание сообщений, форк чата, пересылка ответов на сообщения с изображениями из Telegram, обновление статуса сотрудника и индикатора на аватаре, работа кнопки «Ответ + статус», закрытие чата и отправка опроса CSAT в виджете, самопроизвольная смена статуса агента из «Не в сети»
• 🪟 Чат-виджет: исправлены сброс сессии при переходе между страницами личного кабинета, вставка скриншотов через Ctrl+V, стили и заголовки в списке чатов
• 📧 Почта: исправлена обработка писем в нестандартных кодировках (в том числе ISO-2022-JP), обрезание части письма, цитирование переписки, обработка больших писем и писем с некорректной разметкой, тема уведомления с расшифровкой чата
• 🎫 Заявки: исправлены сброс ответственного при создании, переходы статусов, работа дочерних заявок, очистка поля «Истечение SLA», отображение политик OLA и локаль подписи
• ⚙️ Автоматизации: в контекст триггеров и периодических задач передаются переменные по умолчанию, исправлены условия с исключением значений в триггерах
• 📚 База знаний: нейропоиск больше не предлагает исходную статью как дубликат, в KCS-виджете не пропадают блоки кода и скриншоты, исправлены увеличение изображений после смены локали, вставка изображений в таблицы и ошибка при отмене изменений в редакторе статьи, ошибки при обходе хелпцентра поисковыми роботами
• 📈 Контроль качества: исправлены пустые карточки AQI/LAI на новых установках и мелкие ошибки интерфейса
• ⚙️ Настройки: домен бренда в ссылках, удаление продуктов с версиями и редакциями, отключение максимальной длины пароля, создание администратора при нехватке мест в лицензии, выбор ролей сотрудников при истёкшей лицензии, отображение всех групп в настройках сотрудника, выгрузка поля «Каналы уведомлений», поле темы при создании макроса
• 🤖 ИИ: загрузка файлов ИИ-агентами через MCP, создание ИИ-агентов у неподдерживаемых провайдеров, качество перевода ИИ-ассистентом
• 🔐 Исправлены уязвимости и повышена безопасность системы

Новые переменные окружения

В версии 6.1.0 появились новые параметры в файле .env. Задавать их не обязательно: если переменная не указана, используется значение по умолчанию.

Ограничения на размер и частоту загрузки не распространяются на вложения во входящих письмах.

В версии 6.1.1 добавлена переменная хелпцентра:

В версии 6.1.2 добавлена переменная:

Также в версии 6.1.2 исправлено имя переменной IMAP_SSL_CUSTOM_CIFERS — теперь она называется IMAP_SSL_CUSTOM_CIPHERS. Старое имя продолжает работать, но рекомендуем переименовать переменную в файле .env.

Общая информация

Обновление системы может происходить по одному из трех сценариев:

1. Автоматическое, можно пропустить промежуточные версии – такой сценарий возможен, когда нет изменений в файлах запуска (docker-compose.yml, .env и т.д.) и нет изменений схемы данных, которые удаляют какие-либо данные.
2. Автоматическое, нельзя пропустить промежуточную версию - этот сценарий задействован, когда нет изменений в файлах запуска (docker-compose.yml, .env и т.д.), но есть изменения схемы данных, которые удаляют какие-либо данные. Промежуточное обновление необходимо для того, чтобы сохранить эти данные для дальнейшего использования. С точки зрения администратора системы, выполняющего обновление, никаких дополнительных действий делать не нужно, автоматика самостоятельно произведет все необходимые действия, но время обновления вырастет и будет производен дополнительный рестарт на промежуточной версии.
3. Ручное - такой сценарий возможен, когда есть изменения в файлах запуска (docker-compose.yml, .env и т.д.) и требуется прочитать инструкцию по выполнению обновления и выполнить все указанные там действия.

Выполнение обновления

Обновление выполняется из каталога установки /root/swarmica:

make upgrade-plan    # показать план обновления, ничего не меняя
make upgrade         # выполнить обновление

1. Переходим в директорию Свормики:

   cd /root/swarmica
   

2. make upgrade-plan скачивает манифест обновлений и строит план до последнего релиза. Рекомендуется выполнять сначала эту команду, чтобы оценить длительность обновления и планируемое количество действий
3. make upgrade скачивает манифест обновлений, строит план до последнего релиза и выполняет его по шагам.

Каждый шаг: проверки, скачивание образов, резервная копия БД, запись версий в .env, запуск контейнеров с ожиданием миграций, post_start. Всё, что может завершиться ошибкой, выполняется до изменения .env: при сбое на этом этапе ничего не меняется. Если шаг прервался после изменения .env, повторный make upgrade продолжит его с места остановки, а при сбое печатается точная инструкция по откату.

• Для шагов, требующих ручной подготовки, обновление останавливается и показывает ссылку на инструкцию. После подготовки и выполнения всех шагов из инструкции: make upgrade ACK=vX.Y.Z.
• Автоматическое обновление доступно только с релизной версии. Если в .env указаны main или devel, укажите фактический релиз: make set-release VERSION=vX.Y.Z, затем make pull up.
  Версию можно узнать в интерфейсе системы в разделе Настройки, если у вас есть затруднения – обратитесь в поддержку Swarmica.

Системные требования

1. Версия Swarmica не ниже v6.0.0 – до нее необходимо обновиться вручную согласно инструкциям промежуточных версий
2. Для обновления требуются Docker Compose не ниже 2.24.6, GNU make 4.x, jq 1.6 и новее, curl и flock.

Переход на автообновление

1. Скачайте последнюю версию архива установщика на сервер со Swarmica:

   wget https://support.swarmica.com/attachments/installer/installer.tar.gz
   

2. Распакуйте архив:

   tar -xvzf installer.tar.gz templates/Makefile
   

3. Скопируйте Makefile в каталог, где установлена Swarmica:

   cp templates/Makefile /root/swarmica/
   

4. Проверьте, что у вас есть переменная SW_RELEASE_VERSION в /root/swarmica/.env, и если ее нет - добавьте с указанием той версии, которая установлена на сервере (можно посмотреть в разделе Настройки)

Инструкция

Подготовка

Для обновления проверьте, что в конфигурационном файле .env поставлена версия:

~# grep VERSION .env
SW_FRONTEND_VERSION=v6.0.3
SW_BACKEND_VERSION=v6.0.3
SW_HELPCENTER_VERSION=v6.0.3

Обновление

Выполните обновление с перезагрузкой системы:

docker compose pull
docker compose down
docker compose up -d

После обновления

После того, как все контейнеры запустятся и сервис станет доступен через веб-интерфейс, выполните пост-апгрейдные шаги:

1. Запустите команду пост-старт, чтобы обновить файлы статики, индексы поиска и выполнить другие необходимые процедуры:

docker exec --env-file .env -it swarmica-django-1 python manage.py post_start

2. Запустите очистку неиспользуемых данных:

docker system prune -a

Новые фича-флаги

__ai_mcp_agents - включает возможность создания ИИ-агентов (см. возможности ИИ провайдеров)

rca - включает управление документами анализа первопричин (Root Cause Analysis, RCA)

ui_widgets - включает возможность встраивать в интерфейс Swarmica произвольные виджеты

child_tickets - включает возможность создавать связанные дочерние тикеты, по аналогии с external_tickets, но внутренние дочерние тикеты учитываются в статистике и предназначены для работы сотрудников компании, а не внешних получателей

__password_blacklist - включает возможность управления списком скомпроментированных паролей и запрещать их к использованию. Читать подробнее

🚀 Что нового в обновлении

🤖 ИИ-агенты

Появилась возможность создавать полноценных ИИ-агентов, которые могут использовать инструменты MCP для выполнения рутинных задач, забирая на себя монотонную работу с сотрудников. В этом обновлении представлены три компетенции ИИ-агентов:

1. Проверяющий качества сервиса (QA evaluator)
2. Проверяющий качества контента (AQI evaluator)
3. Проверяющий точность связанности (LAI evaluator)

Эти функции доступны с ИИ-провайдерами YandexGPT и ChatGPT и подключаются фича-флагом __ai_mcp_agents

🔍 RCA

Добавилась возможность создавать документы с анализом первопричин инцидента (Root Cause Analysis, RCA), а так же делиться этими документами с клиентами через интерфейс системы или экспорт в форматах PDF и Markdown. Для большего удобства работы с RCA есть следующие функции:

• 🤖 Генерация документа RCA с помощью ИИ
• 📋 Шаблоны RCA
• 🔒 Возможность добавлять внутреннюю информация, которая не будет видна для клиентов

Включается фича-флагом rca

🎨 Кастомизация интерфейса

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

• 🧩 Собственные настройки основных экранов в заявке, статье, карточке пользователя, организации, лицензионного ключа и актива. Возможность задавать порядок боксов, порядок полей, скрывать поля, который применяется для всех пользователей по умолчанию.
• 🧩 Добавление веб-плагинов через механизм кастомных виджетов (фича-флаг ui_widgets) позволит расширить возможности интерфейса Swarmica и подключить различные внешние системы и веб-виджеты для сотрудников и клиентов
• ✉️ Возможность добавлять кастомизируемое сообщение в форме тикета, для того, чтобы проинформировать клиентов о различных важных нюансах: например, куда обращаться с запросами по приобритению продукта, как продлить лицензию и т.д. Сообщение гибко параметризуется за счет использования шаблонов Jinja.
• 👁️ Возможность скрывать поле «Приоритет» на форме создания
• 🖼️ Возможность задавать кастомную иконку для встраиваемого чат-виджета
• 🎨 Поддержка стилизации встраиваемого чат-виджета через CSS темы бренда

⚙️ ITIL/ITSM

В релизе добавились механизмы, упрощающие внедрения практик ITIL/ITSM:

• ⏱️ Механизм подсчета Операционного Соглашения (Operation-level Agreement, OLA):
  • 🔧 Механизм OLA и политики OLA для различных команд
  • 📊 Графики OLA и соблюдения политик OLA в аналитике
• 📑 Возможность создавать различные Типы запросов по ITIL/ITSM (Запрос на обслуживание, Инцидент, Проблема и т.д.)
• ✉️ Дочерние заявки (фича-флаг child_tickets) для того, чтобы создавать связанные с запросом клиента задачи во внутренние отделы компании и отслеживать их статус
• 🗓️ Производственные календари и быстрое применение праздников к расписаниям для более гибкого и точного подсчета SLA и OLA

📈 Большие изменения в работе с оценкой качества LAI/AQI/QA

• 🖥️ Новые более удобные экраны работы с оценкой, на которых отображается вся необходимая информация
• 💬 Возможность добавлять общий комментарий к оценке
• 🔗 Удобное управление связями «проверяющий — правило» (из правила назначать проверяющих и наоборот)
• ⚡ Возможность сгенерировать оценки по правилу «прямо сейчас», указав нужных проверяющих и количество оценок
• 👥 Возможность указывать количество оценок на проверяющего для каждого правила, создаваемых по расписанию
• 🧮 Возможность назначать оценки, игнорируя загруженность проверяющего
• ⚖️ Алгоритм перебалансировки, учитывающий загруженность проверяющего
• 📊 Возможность создать оценки AQI для редактора и для автора
• 🗑️ Возможность удалять созданные оценки при удалении соответствующего правила

🖥️ Улучшения UI/UX

• 🔎 Поиск по полям в фильтрах
• 📑 Сортировки и быстрый поиск по разделам в настройках
• 🛠️ Визуальный конструктор форм к кастомным скриптам + новый тип поля «Выпадающий список»
• 📋 Быстрый список заявок при выборе целевой заявки для объединения
• 📝 Кнопка «копируемый блок» в редакторе статей
• ⬇️ Индикатор скачивания большого вложенного файла
• 🚫 Индикатор заблокированного пользователя
• 🖼️ Предварительный просмотр изображений на форме создания тикета и коммента
• 🔍 Фильтрация событий в заявке
• ✍️ Удобное написание коммента (автофокус)
• 💾 Сохранение данных в форме до успешного создания тикета

📚 Хелпцентр

• 👍👎 Помогло/Не помогло на статье для неавторизованных пользователей
• 📖 Содержание раздела
• 🖼️ Оптимизация загруженных картинок на обложку продукта и раздела базы знаний, что улучшает скорость загрузки и положительно влияет на SEO

🔐 Безопасность

• 🔑 Возможность задавать политику сложности паролей
• 🚫 Возможность запретить использовать скомпроментированные и популярные пароли

⚙️ Улучшения производительности и обслуживания

• 🔄 Механизм автоматического выполнения post-upgrade команд при обновлении
• 🔌 Переход на единое соединение вебсокета вместо нескольких, автоматическое переподключение и keepalive проверки для более стабильного соединения и устойчивости при нестабильной скорости и качестве Интернет-соединения
• 🛠️ Возможность настройки параметров celery для тонкой настройки производительности сервера
• 📏 Лимит максимального количества объектов на одной странице API запроса LIST

🌐 Разное

• 💬 Поддержка чатов в МАКС
• 🆕 Новый тип каналов — Web / API и возможность отключать их
• ⏲️ Настройка автоматических переходов и автоматических уведомлений с гранулярностью до секунд
• 🔄 Возможность задать алгоритм действий с событиями из прошлого для триггерных автоматизаций
• 👤 Управление аватарками сотрудников (для админов)
• 🔌 Поддержка динамических переменных в адресе URL для исходящего вебхука
• 🔍 Новые возможности в фильтрах:
  • 🔘 оператор isnull для разделов статей в фильтрах
  • 🔘 оператор НЕРАВНО для авторов статей в фильтрах
  • 🔘 оператор isnull для группы в фильтрах тикетов

Инструкция

Подготовка

Для обновления проверьте, что в конфигурационном файле .env поставлена версия:

~# grep VERSION .env
SW_FRONTEND_VERSION=v5.12.1
SW_BACKEND_VERSION=v5.12.1
SW_HELPCENTER_VERSION=v5.12.1

Обновление

Выполните обновление с перезагрузкой системы:

docker compose pull
docker compose down
docker compose up -d

После обновления

После того, как все контейнеры запустятся и сервис станет доступен через веб-интерфейс, выполните пост-апгрейдные шаги:

1. Запустите команду пост-старт, чтобы обновить файлы статики, индексы поиска и выполнить другие необходимые процедуры:

docker exec --env-file .env -it swarmica-django-1 python manage.py post_start

2. Запустите команду миграции модели пермиссий на кастомные поля:

docker exec --env-file .env -it swarmica-django-1 python manage.py migrate_cf_permissions

3. Запустите очистку неиспользуемых данных:

docker system prune -a

Новые фича-флаги

__ai_ticket_summary - для ИИ-провайдеров, поддерживающих эту функцию, включает возможность резюмировать заявки

__delete_comment_attachments - разрешает сотрудникам поддержки с ролью Агент, Менеджер или Администратор удалять вложенные файлы в заявках

__private_attachments - включает режим дополнительной защиты вложенных файлов, запрещая их предварительный просмотр и доступ по прямой ссылке без авторизации. Дополнительно, можно регулировать степень размытия миниатюр изображений таких файлов с помощью переменной env PRIVATE_THUMBNAIL_BLUR_RADIUS (по умолчанию 12 пикселей, чтобы отключить - укажите 0)

✨ Основные улучшения

🧠 ИИ-функции:

• Теперь можно в один клик получить полное Резюме всей переписки в заявке, а так же рекомендации по улучшению качества сервиса

🔐 Безопасность и приватность:

• Расширили возможности по настройке доступа к Кастомным полям: теперь можно для каждой роли указывать возможность видеть и редактировать то или иное поле
• Добавили режим повышенной защиты для вложенных файлов – теперь для них не существует прямой ссылки, (включается фича-флагом __private_attachments)
• Добавили возможность "мягкого" и полного удаления вложенных файлов через веб-интерфейс

🎯 Фильтры и массовые действия:

• Добавили возможность массового редактирования навыков в заявках
• Добавили возможность задавать навыки через Макросы
• Добавили возможность фильтрации заявок и пользователей без навыков (оператор ISNULL)

⚙️ Автоназначение и работа с заявками:

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

🔌 Интеграции и экосистема:

• Для исходящих вебхуков добавилась возможность настраивать параметры действий при ошибке: количество повторных попыток, время между попытками, HTTP статусы, на которые выполнять повторные попытки
• Для исходящих вебхуков добавилась возможность передавать ключ идемпотентности в теле запроса или в заголовках
• Добавили возможность проверять настройки авторизации в ИИ-провайдерах

📚 Работа со статьями и базой знаний:

• Добавили возможность копировать часть статьи из KCS-виджета в буфер обмена или вставлять непосредственно в ответ клиенту с помощью перетаскивания
• Для авторизованных сотрудников в базе знаний отображаются Архивные статьи, с пометкой об их возможной неактуальности
• Добавили поддержку языков cmake и Makefile в блок кода редактора статей
• Добавили настраиваемое почтовое уведомление при снятии флага на доработку статьи

🎨Общие улучшения:

• Добавили возможность настраивать роли и состояние "по умолчанию" для почтовых уведомлений, а так же массово применять новые настройки ко всем пользователям системы
• Добавили индикатор сворачивания/разворачивания панелей в заявке
• Добавили возможность сбрасывать сортировку списков при повторном нажатии на название колонки
• Добавили возможность выбора Категорий шаблонов в окошке быстрой вставки шаблона ответа
• Добавили возможность клиентам самостоятельно переводить заявки в статус Решена из статуса Новая
• Добавили динамический заголовок вкладки браузера для всех разделов системы

🔧Устранены проблемы:

• Лишняя HTML/XML разметка в заявках, созданных через почту
• Сбрасывается выбор отображения тела KCS статьи в заявке

Инструкция

Подготовка

Для обновления проверьте, что в конфигурационном файле .env поставлена версия:

~# grep VERSION .env
SW_FRONTEND_VERSION=v5.11.2
SW_BACKEND_VERSION=v5.11.2
SW_HELPCENTER_VERSION=v5.11.2

Удалите контейнер cron из раздела services docker-compose.yml и том swarmica_cron_d из раздела volumes и всех сервисов:

volumes:
  swarmica_postgres_data: {}
  swarmica_postgres_data_backups: {}
  swarmica_static: {}
  swarmica_logs: {}
  swarmica_ugc: {}
  swarmica_ai_assistant: {}
  swarmica_uploads: {}
  swarmica_runtime: {}
#  swarmica_cron_d: {} Эту строчку нужно удалить
  traefik_data: {}

services:
  django: &django
    ...
#      - swarmica_cron_d:/swarmica/swarmica/cron_d/:z Эту строчку нужно удалить

# Эту секцию целиком нужно удалить
#  cron:
#    <<: *django
#    restart: always
#    depends_on:
#      - postgres
#      - redis
#    command: /start-cron
#    volumes:
#      - ./.env:/etc/environment:ro
#      - swarmica_ai_assistant:/swarmica/swarmica/ai_assistant/articles/:z
#      - swarmica_cron_d:/etc/cron.d/:z
#      - swarmica_ugc:/swarmica/swarmica/attachments:z
#      - swarmica_runtime:/swarmica/swarmica/runtime_scripts/:z
#    labels:
#      - "traefik.enable=false"

Обновление

Выполните обновление с перезагрузкой системы:

docker compose pull
docker compose down --remove-orphans
docker compose up -d 

После обновления

После того, как все контейнеры запустятся и сервис станет доступен через веб-интерфейс, выполните пост-апгрейдные шаги:

1. Запустите команду пост-старт, чтобы обновить файлы статики, индексы поиска и выполнить другие необходимые процедуры:

docker exec --env-file .env -it swarmica-django-1 python manage.py post_start

2. Запустите команду для сохранения порядка пунктов меню в кастомных полях Меню и Бейдж:

docker exec --env-file .env -it swarmica-django-1 python manage.py migrate_choices_order

3. Запустите команду для создания периодических задач по сбору почты через IMAP:

docker exec --env-file .env -it swarmica-django-1 python manage.py migrate_collect_imap_emails

4. Запустите команду для пересчета количества связанных со статьями заявок:

docker exec --env-file .env -it swarmica-django-1 python manage.py calculate_article_t_links_all

5. Если вы используете ИИ-провайдер Yandex, то выполните следующую команду:

docker exec --env-file .env -it swarmica-django-1 python manage.py migrate_yandexgpt_url

6. Выполните команду создания шаблонных карточек для проверки AQI (контроль качества статей):

docker exec --env-file .env -it swarmica-django-1 python manage.py migrate_aqi_cards
docker exec --env-file .env -it swarmica-django-1 python manage.py restore_aqi_sample_rules

7. Выполните команду создания шаблонных карточек для проверки LAI (контроль точности связанности):

docker exec --env-file .env -it swarmica-django-1 python manage.py migrate_lai_cards
docker exec --env-file .env -it swarmica-django-1 python manage.py restore_lai_sample_rules

8. Запустите очистку неиспользуемых данных:

docker system prune -a

✨ Основные улучшения

🤖 AI

• ⚡️⚡️⚡️ Добавлена поддержка собственной (локальной) LLM через OpenAI API
• Добавлена поддержка новых AI-провайдеров:
  • ChatGPT
  • DeepSeek

📊 Отчёты и автоматизации

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

🧠 Контроль качества

• Реализовано полноценное управление собственными правилами оценки Точности связанности и Индекса качества статей.
• Переработаны разделы оценки Контроля Качества, Точности связанности и Индекса качества статей – добавлены фильтры, сортировки и поиск.

📩 Омниканальность

• Добавлена поддержка работы Telegram через прокси сервер.
• Улучшена надежность работы Email каналов при нестабильном сетевом соединении.

🎨 Интерфейс и UX

• Добавлена поддержка массового обновления статей.
• Добавлена возможность удаления локализации статьи.
• Добавлена возможность drag-and-drop сортировки пунктов выбора в кастомных полях типа Меню или Бейдж.
• Появилась возможность сворачивания длинных комментариев.

🔧 Исправленные ошибки

• 🎨 Исправлены проблемы с отображением layout’ов, вложений и комментариев.
• 🧾 Исправлены race condition при обновлении тикетов, SLA и fork операций.
• 💬 Улучшена стабильность и расширено покрытие сценариев установщика Swarmica
• ⚙️ Повышена стабильность фоновых задач, кеширования и AI Assistants.
• 🧩 Исправлены проблемы с генерацией ревизий статей и обновлением вложений.

Симптомы

После обновления до версии 5.10.0 клиент столкнулся с проблемой: интерфейс Swarmica не загружается, не удаётся даже добраться до экрана авторизации, идёт бесконечная загрузка. При этом сам сервер Swarmica работает, уведомления в Max приходят, email-рассылка функционирует.

Решение

1. Проверить логи контейнера Swarmica с помощью команды docker logs swarmica-django-1.
2. Если в логах содержится сообщение вида:

   RuntimeError: NumPy was built with baseline optimizations:
   (X86_V2) but your machine doesn't support:
   (X86_V2).
   

   это указывает на проблему с эмуляцией процессора в виртуальной машине.
3. Выключить виртуальную машину.
4. Переключить тип эмуляции процессора в режим host.
5. Включить виртуальную машину обратно.

Причина

Проблема возникла из-за отсутствия необходимых флагов процессора (ssse3, sse4_1, sse4_2 и popcnt) в настройках эмуляции процессора виртуальной машины. После обновления Swarmica до версии 5.10.0 была обновлена версия Python до 3.13 и библиотека NumPy, которая использует указанные оптимизации.

Симптомы

Нужна переустановка Свормики. Как удалить имеющуюся сейчас установку с сервера?

Решение

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

cd /root/swarmica
docker compose down -v

потом перейти в папку с инсталлером и

rm -rf .tmp
./installer.sh install

Симптомы

Пользователь при попытке открыть Свормику в браузере сталкивается с ошибкой Your token is invalid или перманентной загрузкой страницы. При этом в других браузерах сайт открывается без проблем.

Решение

1. В любом месте на странице нажать правой кнопкой мыши и выбрать «Посмотреть код» (Inspect).
2. Выбрать вкладку «Приложение» (Application).
3. В ней слева найти «Локальное хранилище» (Local Storage).
4. Выбрать сайт (https://yourhelp.yourdomain.tld) — на нём нажать правой кнопкой мыши и выбрать пункт «Очистить» (Clear).
5. Затем выполнить принудительное обновление страницы (форс-рефреш) и снова зайти на сайт.

Причина

Проблема возникла из-за закэшированного старого токена авторизации.

Инструкция

Подготовка

Для обновления проверьте, что в конфигурационном файле .env поставлена версия:

~# grep VERSION .env
SW_FRONTEND_VERSION=v5.10.0
SW_BACKEND_VERSION=v5.10.0
SW_HELPCENTER_VERSION=v5.10.0

# grep -m1 'flags' /proc/cpuinfo
flags           : fpu vme de pse tsc msr pae mce cx8 apic sep mtrr pge mca cmov pat pse36 clflush mmx fxsr sse sse2 ss ht syscall nx pdpe1gb rdtscp lm constant_tsc arch_perfmon rep_good nopl xtopology cpuid tsc_known_freq pni pclmulqdq vmx ssse3 fma cx16 pdcm pcid sse4_1 sse4_2 x2apic movbe popcnt tsc_deadline_timer aes xsave avx f16c rdrand hypervisor lahf_lm abm 3dnowprefetch cpuid_fault invpcid_single ssbd ibrs ibpb stibp ibrs_enhanced tpr_shadow vnmi flexpriority ept vpid ept_ad fsgsbase tsc_adjust bmi1 avx2 smep bmi2 erms invpcid mpx avx512f avx512dq rdseed adx smap clflushopt clwb avx512cd avx512bw avx512vl xsaveopt xsavec xgetbv1 xsaves arat umip pku ospke avx512_vnni md_clear arch_capabilities

Обновление

Выполните обновление с перезагрузкой системы:

docker compose pull
docker compose down
docker compose up -d

После обновления

После того, как все контейнеры запустятся и сервис станет доступен через веб-интерфейс, выполните пост-апгрейдные шаги:

1. Запустите команду пост-старт, чтобы обновить файлы статики, индексы поиска и выполнить другие необходимые процедуры:

docker exec --env-file .env -it swarmica-django-1 python manage.py post_start

Эта команда может занять долгое время, в зависимости от количества данных в системе.

2. Запустите очистку неиспользуемых данных:

docker system prune -a

✨ Основные улучшения

🔐 Безопасность и интеграции

• Версия python в backend ядре системы обновлена до 3.13
• Администраторы теперь могут отключать 2FA у пользователей без подтверждения пароля.
• Добавлена возможность использовать ключи идемпотентности в API запросах

🧠 AI и работа с ИИ

• Добавлена возможность управлять промптами для ИИ-функций для кастомизации:
  • Ваш Tone of Voice
  • Создания черновиков статей в вашей структуре
  • Работа с переводами и редакцией текста для тикетов и статей
  • Промпты для Виртуального агента

📊 Отчёты и аналитика

• Добавлены новые модификаторы для дат: неделя, месяц, квартал с учетом часового пояса.
• Поддержка относительных дат
• Добавлена возможность пересчёта агрегированных метрик через API и UI.
• Возможность тонкой настройки Точности vs Скорости подсчета метрик в аналитике.

⚙️ Автоматизация и триггеры

• Расширены возможности для действий по расписанию и событиям:
  • поддержка относительных дат в условиях для автоматизаций вида: "Отправить сообщение если нет ответа от агента последние 30 минут"
  • новые операторы (например, IEXCLUDES)
• Автоматическая подстройка макросов под события в тикете event.ticket.id.

💬 Интерфейс и UX

• Добавлены новые статусы агентов: Перерыв и В Работе.
• Реализована возможность настройки кастомного лейаута экрана тикета: изменение порядка и минимизация блоков
• Минималистичный (свернутый) интерфейс SLA-счетчиков в тикете
• Поддержка открытия формы создания тикета с URL-параметром assignee=me
• Добавлены hash-ссылки на события в тикете

🌐 Брендинг и настройки

• В настройки бренда добавлена возможность конфигурации системы:
  • Протокол (https/http) доступа для конфигурации собственных обратных прокси
  • Имя домена (по которому доступна система)
  • Порт доступа

🔧 Исправленные ошибки

• 📊 Исправлены расчёты SLA, прогресс-бары и обновление метрик в условиях race condition.
• 💬 Исправлены ошибки отображения комментариев и шаблонов в определенных условиях/браузерах.
• ⚙️ Повышена стабильность системы: кэш, фоновые задачи, обработка событий и API.

Инструкция

Подготовка

Для обновления проверьте, что в конфигурационном файле .env поставлена версия:

~# grep VERSION .env
SW_FRONTEND_VERSION=v5.9.2
SW_BACKEND_VERSION=v5.9.2
SW_HELPCENTER_VERSION=v5.9.2

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

Так же, на этом же шаге можно подключить оптимизацию портала базы знаний для LLM.

Обновление

Выполните обновление с перезагрузкой системы:

docker compose pull
docker compose down
docker compose up -d

После обновления

После того, как все контейнеры запустятся и сервис станет доступен через веб-интерфейс, выполните пост-апгрейдные шаги:

1. Запустите команду пост-старт, чтобы обновить файлы статики, индексы поиска и выполнить другие необходимые процедуры:

docker exec --env-file .env -it swarmica-django-1 python manage.py post_start

Эта команда может занять долгое время, в зависимости от количества данных в системе.

2. Запустите команду переименования поля chat_status в status:

docker exec --env-file .env -it swarmica-django-1 python manage.py migrate_chat_status_to_status

3. Запустите команду переноса статуса автоназначения в поле status:

docker exec --env-file .env -it swarmica-django-1 python manage.py migrate_autoassign_to_status

4. Если вы используете YandexGPT, то в этом релизе необходимо его перенастроить:

4.1. Переключите модель с YandexGPT-Lite на YandexGPT

docker exec --env-file .env -it swarmica-django-1 python manage.py migrate_yandex_gpt_model

4.2. Сбросьте состояние YandexGPT до "чистого":

docker exec --env-file .env -it swarmica-django-1 python manage.py wipe_yandex_cloud

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

5. Запустите подсчет коэффициента несоблюдения SLA, который используется для упорядочивания тикетов при автоназначении:

docker exec --env-file .env -it swarmica-django-1 python manage.py recalculate_sla

6. Запустите команду установки порядка избранных списков тикетов "по умолчанию":

docker exec --env-file .env -it swarmica-django-1 python manage.py migrate_user_filter_subscriptions

7. Запустите очистку неиспользуемых данных:

docker system prune -a

✨ Основные улучшения

🔐 Безопасность и доступы

• Возможность использования 2FA через TOTP и Email
• Черный список скомпроментированных JWT токенов
• Маскирование паролей, токенов и других чувствительных данных в API
• Защищенная форма ввода паролей, токенов и других чувствительных данных

🧠 Работа со статьями

• Возможность перевода всей статьи целиком (ИИ)
• Возможность создания 30+ вкладок (табов) в статью
• Авто-якоря заголовков
• События изменения статусов и сегментов статей
• Расширенные настройки SEO для статей
• Оптимизация базы знаний для LLM

📬 Автоматизация и шаблоны

• Поддержка Jinja в email-автоматизациях (to / cc / bcc)
• Поддержка Jinja переменных в тикетах
• Добавлен Индекс SLA, как интегральный показатель соблюдения/несоблюдения всех счетчиков, сконфигурированных в политиках, применяемых к тикетам

📊 Отчеты и фильтры

• Добавлены новые объекты и измеряемые сущности
• Поддержка isnull для продуктов/компановки/версий/платформ
• Модификаторы Час и День недели для полей типа Дата и время в отчетах + возможность задавать часовой пояс для этих модификаторов
• Возможность сортировки в конструкторе отчётов
• Возможность поиск по отчётам в конструкторе отчетов
• Доступ к отчетам для роли Менеджер в конструкторе отчетов

💬 Мессенджеры и каналы

• Углублена интеграция с MAX
• Добавлены настройки, ссылки и поддержка в виджете

🔧 Исправленные ошибки

🎨 Исправлены проблемы с редактором: видео, форматирование текста, отмена, выпадающие меню и стили.
📊 Отображение в отчётах: локали, даты, SLA-счётчики и отображение данных.
🧾 Исправлены ошибки логики автоназначения и обработки событий.
💬 Улучшена стабильность мессенджеров и обработка комментариев.
⚙️ Повышена стабильность и производительность системы: кэш, API, миграции и фоновые процессы.

Инструкция

Подготовка

1. Для обновления проверьте, что в конфигурационном файле .env поставлена версия:

~# grep VERSION .env
SW_FRONTEND_VERSION=v5.8.0
SW_BACKEND_VERSION=v5.8.0
SW_HELPCENTER_VERSION=v5.8.0

2. Ознакомьтесь со статьей про фича-флаги и убедитесь, что вы заменили старые значения на новые или добавили отсутствующие в /root/swarmica/.env в переменной FEATURES:

3. Ознакомьтесь с инструкцией подключения мессенджера MAX, если вы планируете подключить эту интеграцию

Обновление

Выполните обновление с перезагрузкой системы:

docker compose pull
docker compose down
docker compose up -d

После обновления

После того, как все контейнеры запустятся и сервис станет доступен через веб-интерфейс, выполните пост-апгрейдные шаги:

1. Запустите команду пост-старт, чтобы обновить файлы статики, индексы поиска и выполнить другие необходимые процедуры:

docker exec --env-file .env -it swarmica-django-1 python manage.py post_start

Эта команда может занять долгое время, в зависимости от количества данных в системе.

2. Запустите команду, которая установит свойство locale для всех имеющихся тикетов в системе:

docker exec --env-file .env -it swarmica-django-1 python manage.py migrate_ticket_locale

3. Запустите команду, чтобы установить порядок разделов базы знаний по умолчанию:

docker exec --env-file .env -it swarmica-django-1 python manage.py migrate_articlecategory_order

4. Запустите команду, которая установит порядок продуктов на формах и в базе знаний по умолчанию:

docker exec --env-file .env -it swarmica-django-1 python manage.py migrate_product_order

5. Запустите команду, которая сделает связь тикетов двусторонней:

docker exec --env-file .env -it swarmica-django-1 python manage.py migrate_related_tickets

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

docker exec --env-file .env -it swarmica-django-1 python manage.py migrate_event_value_data

7. Запустите очистку неиспользуемых данных:

docker system prune -a

✨ Основные улучшения

💬 🅿️ Добавили возможность подключать мессенджер MAX как канал

💅 Добавили визуальный конструктор для макросов

👨‍🔧 Упростили создание сложных автоматизаций

🤌 Сделали клонирование правил автоназначения, чтобы экономить время на создании похожих правил

🪢 Сделали двустороннюю прозрачную связь заявок

🌎 Добавили возможность менять язык, на котором идет общение в заявке

🧩 Теперь можно задавать произвольный порядок для разделов базы знаний и продуктов

💆‍♀️ Добавили информации о запусках периодических задач и визуальный редактор условий

📊 Расширили и углубили возможности для создания произвольных отчетов

🔧 Исправленные ошибки

🎨 Исправлены проблемы с видео в статьях, копированием кода, таблицами, курсором и dropdown’ами.

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

🧾 Исправлены ошибки создания SLA, работы относительных дат в QA и массового редактирования. Корректно отображаются логические значения в событиях.

💬 Исправлена обработка CSAT в мессенджерах. Предотвращено создание пустых комментариев.

🧑‍💼 Исправлены ошибки с локалями и параллельным сохранением кастомных полей. Уточнены ограничения ролей.

⚙️ Улучшена работа кэша, логирования SLA и автоматизаций. Обновлены зависимости и закрыты потенциальные уязвимости.

🧩 Исправлено отображение CSAT, вложений и навигации в чатах.

Инструкция

Подготовка

Для обновления проверьте, что в конфигурационном файле .env поставлена версия:

~# grep VERSION .env
SW_FRONTEND_VERSION=v5.7.2
SW_BACKEND_VERSION=v5.7.2
SW_HELPCENTER_VERSION=v5.7.2

Обновление

Выполните обновление с перезагрузкой системы:

docker compose pull
docker compose down
docker compose up -d

После обновления

После того, как все контейнеры запустятся и сервис станет доступен через веб-интерфейс, выполните пост-апгрейдные шаги:

1. Запустите команду пост-старт, чтобы обновить файлы статики, индексы поиска и выполнить другие необходимые процедуры:

docker exec --env-file .env -it swarmica-django-1 python manage.py post_start

Эта команда может занять долгое время, в зависимости от количества данных в системе.

2. Запустите команду удаления ненужных фоновых задач:

docker exec --env-file .env -it swarmica-django-1 python manage.py remove_clean_stale_ws_connections_deprecated_task

3. Запустите команду миграции данных о событиях на новый формат

docker exec --env-file .env -it swarmica-django-1 python manage.py migrate_event_value_data

Данная команда может выполняться достаточно долгое время, в зависимости от объема данных в системе, вплоть до нескольких часов.

4. Запустите команду добавления шаблонов новых сообщений для ботов, если вы используете каналы Telegram, Whatsapp и/или VK:

docker exec --env-file .env -it swarmica-django-1 python manage.py restore_bot_messages

Если вы не используете мессенджеры для получения заявок в Swarmica, этот шаг можно пропустить.

5. Если вы используете ИИ-функции с Yandex GPT, то выполните миграцию с Assistants API на Responses API:

docker exec --env-file .env -it swarmica-django-1 python manage.py migrate_ai_assistants

6. Запустите очистку неиспользуемых данных:

docker system prune -a

✨ Основные улучшения

• 📊 Отчёты и аналитика
  • Сводные таблицы можно создавать с использование только столбцов или только строк.
  • Добавлены измерения по дате создания и обновления.
  • Добавлены фильтры по CC и BCC для тикетов.
• 🧠 Статьи и управление знаниями
  • Улучшен поиск дубликатов статей: используется индексный поиск и более точные подсказки.
  • Возможность создавать и использовать собственные шаблоны для статей.
  • Поддержка событий ревизий статей — основа для автоматизаций и аудита.
  • Расширенные фильтры статей: фильтрация по продуктам, версиям, платформам и задачам.
  • Возможность настраивать видимость статьи до публикации.
• ⚙️ Автоматизация и триггеры
  • Добавлен графический интерфейс с конфигурации действий по условиям
• 🎨 Интерфейс и UX
  • Возможность создания вкладок в редакторе статей.
  • Новые языки для кода (SQL, HTML) и улучшенную работа со ссылками в редакторе статей.
  • Сортировка для по метрикам списках оценок QA / LAI / AQI .
  • Поддержка cc_emails при создании тикета через URL..

🔧 Исправленные ошибки

• 🧾 Тикеты, SLA и QA
  • Исправлены ошибки расчёта SLA.
  • Тикеты на QA-оценку попадают теперь только единожды..
• 💬 Мессенджеры и чаты
  • Telegram: исправлена работа с большим количеством файлов и их именами.
  • Улучшено логирование сообщений.
  • Исправлено поведение чатов при логине и в fullscreen-режиме.
• 📈 API и отчёты
  • Исправлены NaN-значения в отчётах.
  • Корректная фильтрация datetime по дате.
• 🧹 Стабильность системы
  • Упрощена структура core-views и lifecycle-хуков.
  • Улучшена документация CLI-команд и внутренних процессов.
  • AI-ассистент для YandexGPT переведён на Responses API.

Симптомы

После установки Свормки при попытке зайти в панель управления нон-стоп грузится спиннер заставки.

Решение

1. Поправить DNS для указанного домена или же прописать у себя в /etc/hosts , чтобы сервер корректно резолвился по доменному имени в правильный IP адрес сервера
2. Если сервер находится за NAT, то прописать локальный IP адрес сервера в его собственный /etc/hosts
3. Перезапустить скрипт инсталлера

Причина

Указанный при установке домен не резолвится в корректный IP адрес или же попытка доступа напрямую по IP. Swarmica требуется доменное имя для корректной работы.
Проблема с доступом по https сервера к самому себе. Команда curl, которой мы проверяем готовность API, не может завершиться и инсталлер не может закончить установку.

Инструкция

Подготовка

Для обновления проверьте, что в конфигурационном файле .env поставлена версия:

~# grep VERSION .env
SW_FRONTEND_VERSION=v5.6.0
SW_BACKEND_VERSION=v5.6.0
SW_HELPCENTER_VERSION=v5.6.0

Обновление

Выполните обновление с перезагрузкой системы:

docker compose pull
docker compose down
docker compose up -d

После обновления

После того, как все контейнеры запустятся и сервис станет доступен через веб-интерфейс, выполните пост-апгрейдные шаги:

1. Запустите команду пост-старт, чтобы обновить файлы статики, индексы поиска и выполнить другие необходимые процедуры:

docker exec --env-file .env -it swarmica-django-1 python manage.py post_start

Эта команда может занять долгое время, в зависимости от количества данных в системе.

2. Запустите команду создания отсутствующих шаблонов сообщений для WhatsApp и Telegram ботов:

docker exec --env-file .env -it swarmica-django-1 python manage.py restore_bot_messages

3. Если используете модуль Контроль Качества Сервиса, пересчитайте метрику Несоблюдение критериев качества сервиса:

docker exec --env-file .env -it swarmica-django-1 python manage.py aggregated_metric_qa_criteria 500

4. Пересчитайте значения SLA, если используете метрики Время без ожидания и Время решения в поддержке:

docker exec --env-file .env -it swarmica-django-1 python manage.py recalculate_sla -e

5. Запустите очистку неиспользуемых данных:

docker system prune -a

✨ Основные улучшения

• 🔎 Подключение внешних источников для поиска (доступно в Премиум)
  • Теперь Swarmica может искать информацию за пределами своей базы. Можно подключать внешние порталы документации, базы знаний и т.д (при наличии соответствующего API) для поиска непосредственно:
    • В хелпцентре
    • В KCS-виджете, чтобы быстрее находить решения.
    • В веб-виджете
  • Helpcenter также получил поддержку внешнего поиска.
• 📊 Гибкие отчеты (Beta доступно в Премиум)
  • В системе появились система гибких отчетов - построение сводных таблиц по собственному выбору и компоновке метрик с сортировкой, усреднением, суммаризацией и т.д.
• 🧠 KCS и статьи
  • Поддержка ревизий статей и события при их добавлении (для автоматизаций и вебхуков)
  • Добавлено поле issues в /api/articles/ и в экспорт — теперь статьи можно связывать с задачами.
  • Добавлен фильтр по задачам для статей в API и языке запросов.
• 💌 Мессенджеры
  • Реализована отправка и обработка CSAT-оценок в Telegram и WhatsApp.
  • При отправке файлов в Telegram теперь сохраняются оригинальные имена.
• 🧩 UX
  • Теперь при создании шаблона из комментария копируются вложения.
  • Добавлен поиск по имени в в списке фильтров..

🔧 Исправленные ошибки

• 🗂 SLA и метрики
  • Теперь уведомление "тикет назначен" отправляется при создании тикета с заведомо назначенным агентом.
  • Исправлен экспорт тикетов — корректное отображение timedelta и названий связей.
  • Исправлено сохранение и перерасчёт SLA через Celery.
  • Исправлены ошибки в диаграммах QA Criteria.
• 💬 Коммуникации и интеграции
  • Добавлены логи отправки и получения сообщений в WhatsApp.
  • Исправлено обновление выпадающего списка доменов электронной почты.
  • Helpcenter теперь корректно сохраняет параметр URL при переходе по статье.
• ⚡ Производительность и стабильность
  • Исправлено поведение WebSocket-переподключений.
  • Исправлены циклические ссылки в дереве запросов.
  • Оптимизирована работа с кэшом Redis

Инструкция

Подготовка

Для обновления проверьте, что в конфигурационном файле .env поставлена версия:

~# grep VERSION .env
SW_FRONTEND_VERSION=v5.5.3
SW_BACKEND_VERSION=v5.5.3
SW_HELPCENTER_VERSION=v5.5.3

Обновление

Выполните обновление с перезагрузкой системы:

docker compose pull
docker compose down
docker compose up -d

После обновления

После того, как все контейнеры запустятся и сервис станет доступен через веб-интерфейс, выполните пост-апгрейдные шаги:

1. Запустите команду пост-старт, чтобы обновить файлы статики, индексы поиска и выполнить другие необходимые процедуры:

docker exec --env-file .env -it swarmica-django-1 python manage.py post_start

Эта команда может занять долгое время, в зависимости от количества данных в системе.

2. Запустите команду подсчета метрики KvN в новом формате:

docker exec --env-file .env -it swarmica-django-1 python manage.py aggregated_metric_kvn 500

3. Обновите настройки почтовых уведомлений по умолчанию:

docker exec --env-file .env -it swarmica-django-1  python manage.py setup_email_notifications -u -uf 'for_robots'

4. Запустите очистку неиспользуемых данных:

docker system prune -a

✨ Основные улучшения

• 🌍 Хелпцентр и статьи
  • Добавлена фильтрация статей по языку внутри категорий.
  • Статьи теперь отображаются только для выбранной локали, а при фильтрации исключаются пустые переводы.
  • Добавлена сортировка статей по дате публикации — самые свежие наверху.
  • Реализовано удаление комментариев к статьям.
• 🧩 Кастомные поля и фильтры
  • Поддержка фильтра ISNULL (поиск пустых значений) для кастомных полей, пользователей и организаций.
  • Добавлен оператор time range для фильтрации по кастомным полям дата и время.
  • Добавлены индексы для ускорения работы с кастомными полями и перерасчет значений вынесен в отдельную фоновую задачу.
• 💬 Работа с тикетами
  • В шаблонах ответов появились категории, навыки и группы, а также фильтры по этим параметрам.
  • В API добавлено поле автор комментария при создании или редактировании тикета от третьего лица
  • Можно менять дату «До» оставляя тикет в статусе "Ожидание"
  • Перевод из статуса "Ожидание" в Решено и Закрыто.
  • Поддержка таблиц в в ответах (только для почты и ЛК)
• ⚙️ Работа в мессенджерах
  • Поддержка режима работы в группах для Telegram-ботов.
  • Обновлена совместимость и стабильность интеграций с Telegram, WhatsApp и VK — теперь пересылка сообщений надёжнее благодаря транзакционной обработке
• 📱 Чат-виджет
  • Новые стили для поддержки интеграции в мобильное приложение, поддержка параметра fullScreen, новая звёздочная форма CSAT, корректное отображение кнопки «Назад».

🔧 Исправленные ошибки

• 🗂 Тикеты и комментарии
  • Исправлены ошибки при изменении комментариев и отображении полей тикета.
  • Исправлено удаление уведомлений из панели (колокольчика).
  • Исправлено отображение статуса чата и фильтры по организациям пользователей.
• 💬 Интерфейс и стили
  • Исправлены размеры иконок, выравнивание, перенос текста.
  • Улучшен адаптив тикет-формы на мобильных устройствах.
• 📦 Производительность и стабильность
  • Исправлены зависания при загрузке запросов и при открытии Helpcenter.
  • Исправлены ошибки фоновых задач WebSocket и чистка устаревших соединений.
  • Оптимизирована работа с кешем Redis
• 🧠 Метрики и пересчёты
  • Исправлены ошибки расчёта при обновлении тикетов и комментариев.
  • Исправлена конвертация чекбоксов в фильтрах кастомных полей.
• 📱 Виджет чата
  • Исправлено падение виджета при работе в нескольких вкладках браузера.
  • Исправлена обработка кликов по звёздам рейтинга (CSAT) на мобильных устройствах.

Инструкция

Подготовка

Для обновления проверьте, что в конфигурационном файле .env поставлена версия:

~# grep VERSION .env
SW_FRONTEND_VERSION=v5.4.0
SW_BACKEND_VERSION=v5.4.0
SW_HELPCENTER_VERSION=v5.4.0

Обновление

Выполните обновление с перезагрузкой системы:

docker compose pull
docker compose down
docker compose up -d

После обновления

После того, как все контейнеры запустятся и сервис станет доступен через веб-интерфейс, выполните пост-апгрейдные шаги:

1. Запустите команду пост-старт, чтобы обновить файлы статики, индексы поиска и выполнить другие необходимые процедуры:

docker exec --env-file .env -it swarmica-django-1 python manage.py post_start

Эта команда может занять долгое время, в зависимости от количества данных в системе.

2. Запустите команду, которая переведет условия пользовательских фильтров, использующих кастомные поля, в новый формат:

docker exec --env-file .env -it swarmica-django-1 python manage.py migrate_filter_custom_fields

3. Запустите команду, которая перенесет балансировщик, перераспределяющий заявки, на новый движок:

docker exec --env-file .env -it swarmica-django-1 python manage.py migrate_rebalancer

4. Запустите очистку неиспользуемых данных:

docker system prune -a

✨ Основные улучшения

• 🧩 Кастомные поля
  • Поддержка множественного выбора кастомных полей в фильтрах
  • Новые операторы ≥ / ≤ для кастомных полей типа Число и Дата
  • Фильтрация и сортировка по относительным датам (например, «за последние 7 дней»).
• 💻 Интерфейс и удобство работы
  • Улучшен UX работы с тикетами и статьями — длинные строки теперь красиво переносятся.
  • Поддержка Статуса агента в профиле и учет его для автоназначения тикетов и чатов
  • Теперь правила автоназначения для перебалансировки тикетов можно запускать по расписанию через новый механизм, более эффективный по ресурсам и позволяющий задать собственное расписание.
  • Правила автоназначения получили раздельные опции простого перевода в группу и остановки обработки остальных правил
  • В списке статей теперь можно быстро фильтровать по ихid.
• 🧱 Виджет чата
  • Появились новые параметры open и page в URL — они влияют на то, как виджет открывается и маршрутизируется.
  • Поддержка параллельной работы в нескольких браузерах/устройствах.

🔧 Исправленные ошибки

• 🗂 Тикеты и кастомные поля
  • Исправлены ошибки фильтрации и отображения каналов.
• 💬 Чаты и вебсокеты
  • Исправлена логика обновления WebSocket-соединений
  • Исправлены ошибки при обновлении токена и мерцания интерфейса при смене маршрутов.
  • Исправлено подключение и обновление состояния чатов.
• 🧾 Почта и интеграции
  • Исправлено исключение объединённых тикетов при экспорте.
  • Исправлена обработка комментариев без base64-данных в email.
• 🧩 Интерфейс и оформление
  • Исправлены стили списка групп, бейджей навыков, кнопок и тёмной темы.
  • Исправлены отступы, переносы текста и отображение в мобильной версии.

Симптомы

Установка Swarmica зависла на стадии скачивания образов (docker compose pull) на сервисах traefik, postgres и/или redis:

+] Pulling 72/97
 ✔️ celeryworker Skipped - Image is already being pulled by telegram                                                0.0s
 ✔️ celerybeat Skipped - Image is already being pulled by telegram                                                  0.0s
 ✔️ django Skipped - Image is already being pulled by telegram                                                      0.0s
 ✔️ telegram Pulled                                                                                               244.0s
 ✔️ frontend Pulled                                                                                               167.4s
 ⠧ postgres [⠀⠀⠀⠀⠀⠀⠀⠀⠀⠀⠀⠀⠀] Pulling                                                                             1055.8s
 ✔️ cron Skipped - Image is already being pulled by telegram                                                        0.0s
 ⠧ traefik [⠀⠀⠀⠀] Pulling                                                                                       1055.8s
 ⠧ redis [⣿⣿⣿⣿⠀⠀] Pulling                                                                                       1055.8s

Решение

Добавьте зеркало Docker Hub в конфигурацию Docker и перезагрузите сервис:

1. Откройте файл /etc/docker/daemon.json любым удобным редактором
2. Добавьте в секцию registry-mirrors зеркало Yandex:

{
  "registry-mirrors": ["https://cr.yandex/mirror","https://mirror.gcr.io"]
}

1. Перезагрузите сервис docker

invoke-rc.d docker restart

1. Запустите ./install.sh install - он продолжит установку с последнего успешного шага

Причина

Доступ к зеркалу Docker Hub от Google может быть замедлен, в зависимости от вашего провайдера интернета

Симптомы

При развёртывании возникали ошибки, но всё же образ развернулся. Однако при входе на сайт выходит ошибка. При проверке через ./installer.sh check также появляется ошибка.

./installer.sh must be run from root user, exiting now

Решение

1. Выполнить команду sudo для получения прав суперпользователя (root).
2. Запустить установщик ещё раз.

Инструкция

Подготовка

1. Для обновления проверьте, что в конфигурационном файле .env поставлена версия:

~# grep VERSION .env
SW_FRONTEND_VERSION=v5.3.1
SW_BACKEND_VERSION=v5.3.1
SW_HELPCENTER_VERSION=v5.3.1

2. Если вы используете SEO-оптимизированный сервис helpcenter, то проверьте, что настройка выполнена в соответствии с тем, используется ли внешний балансировщик или нет:
1040: Конфигурация SEO-оптимизированного публичного портала базы знаний (helpcenter, хелп-центр)

Обновление

Выполните обновление с перезагрузкой системы:

docker compose pull
docker compose down
docker compose up -d

После обновления

После того, как все контейнеры запустятся и сервис станет доступен через веб-интерфейс, выполните пост-апгрейдные шаги:

1. Запустите команду пост-старт, чтобы обновить файлы статики, индексы поиска и выполнить другие необходимые процедуры:

docker exec --env-file .env -it swarmica-django-1 python manage.py post_start

Эта команда может занять долгое время, в зависимости от количества данных в системе.

2. Запустите очистку неиспользуемых данных:

docker system prune -a

✨ Основные улучшения

• 📱 UX и UI
  • Возможность выбора языка на портале базы знаний для смены локали, а также поиска статей внутри этой локали
  • Оптимизированы стили и сделана адаптивная вёрстка для работы с телефона. Будьте всегда на связи со Swarmica!
  • Возможность перетаскивать и расширять окно ответа в тикете
  • Возможность включать/выключать автоназначение прямо из списка сотрудников
  • Фильтрация по группам прямо в списке сотрудников
• 📄 Работа с тикетами
  • Возможность создания исходящих тикетов для взаимодействия со смежными подразделениями или контрагентами вне Swarmica
  • Возможность создавать дочерние тикеты и управлять ими из основного окна для взаимодействия со смежными подразделениями внутри Swarmica
  • Возможность выбора формата уведомлений о тикетах (html или plain) для конкретных пользователей
  • Флаги для аккаунтов третьих систем для отключения служебных уведомлений по тикетам и минимизации "битвы роботов"
• 🤖 AI и KCS
  • Индексация и векторизация первичных черновиков статей для использования AI-ассистентом.
  • Возможность обновить уже созданную и привязанную WIP статью в тикете при появлении дополнительной информации и/или финального решения
• ⚙️ Автоматизация и триггеры
  • Поддержка макросов для триггеров и cron-задач.
  • Возможность добавлять действия в списки триггеров и cron-jobs.
  • Возможность скачивать код скриптов прямо из интерфейса.
• 🎧 Интеграции и каналы связи
  • Добавлен новый канал: телефония Beeline PBX для создания тикетов по звонку и логирования записей разговора.
• 🧩 Контроль качества (QA)
  • Возможность изменять оцениваемого сотрудника в процессе оценки
  • Возможность удаления оцениваемой сущности
  • Добавлен расчёт процента выполнения правил QA критериев.

🔧 Исправленные ошибки

• 🧾 Тикеты и SLA
  • Исправлена проверка SLA-политик и счётчиков после комментариев.
  • Устранены проблемы с валидацией email и URL в формах тикетов.
  • Исправлено отображение свойств организаций без доменов.
• 💬 Чаты и боты
  • Исправлено задваивание сообщений
  • Исправлена передача канала при блокировке пользователя.
• 🧑‍💼 Пользователи и права
  • Исправлены коды ошибок API и валидация ролей.
  • Добавлены уникальные ошибки при создании пользователя с уже существующим email.
• 📊 QA и оценки
  • Исправлена фильтрация карт QA по правилам.
  • Исправлено отображение даты и поля оцениваемого.
• 📡 Интеграции и экспорт
  • Исправлена ошибка передача данных при экспорте отчётов
  • Добавлены метатеги кодировки в шаблоны экспорта.
  • Исправлен разбор вложений email в формате message/rfc822.

Симптомы

Не удается установить обновление Swarmica. На шаге docker compose pull ошибка:

Login did not succeed, error: Error response from daemon: Get "https://reg.gl.swd.im/v2/": unauthorized: HTTP Basic: Access denied. If a password was provided for Git authentication, the password was incorrect or you're required to use a token instead of a password

Решение

Обратитесь в поддержку Swarmica, чтобы получить новый токен доступа к репозиторию

Причина

Истек срок действия токена доступа к репозиторию Swarmica

Инструкция

Подготовка

1. Для обновления проверьте, что в конфигурационном файле .env поставлена версия:

~# grep VERSION .env
SW_FRONTEND_VERSION=v5.2.0
SW_BACKEND_VERSION=v5.2.0
SW_HELPCENTER_VERSION=v5.2.0

2. Отредактируйте файл docker-compose.yml, чтобы отразить необходимые изменения:

• Для сервиса frontend замените параметр depends_on на django и убедитесь, что роутинг (правило .rule в лейблах) указывает только на Host, если есть дополнительные параметры - удалите их.

  frontend:
    image: reg.gl.swd.im/swarmica/frontend:${SW_FRONTEND_VERSION}
    depends_on:
      - django
    restart: always
    volumes:
      - ./robots.txt:/usr/share/nginx/html/robots.txt:ro
      - swarmica_static:/admin_static:ro
      - swarmica_ugc:/attachments:ro
    labels:
      - "traefik.enable=true"
      - "traefik.http.routers.frontend-router.entrypoints=web-secure"
      - "traefik.http.routers.frontend-router.rule=Host(`${SW_HOSTNAME}`)"
      - "traefik.http.routers.frontend-router.tls.certresolver=letsencrypt"
      - "traefik.http.routers.frontend-router.priority=10"
      - "traefik.http.routers.frontend-router.middlewares=secure-headers,compression"

• После секции celeryworker добавьте еще один сервис celerybeat:

  celerybeat:
    <<: *django
    restart: always
    depends_on:
      - postgres
      - redis
    command: /start-celerybeat
    labels:
      - "traefik.enable=false"

• В секции traefik замените параметр depends_on на frontend:

...
  traefik:
    image: traefik:latest
    depends_on:
      - frontend
    restart: always
...

• Если вы планируете использовать SEO-оптимизированный публичный портал базы знаний, то добавьте сервис helpcenter:

  helpcenter:
    image: reg.gl.swd.im/swarmica/helpcenter:${SW_HELPCENTER_VERSION}
    restart: always
    depends_on:
      - django
    env_file:
      - .env
    volumes:
      - .env:/app/.env
    labels:
      - "traefik.enable=true"
      - "traefik.http.services.helpcenter.loadbalancer.server.port=4000"
      - "traefik.http.routers.helpcenter-router.rule=Host(`${SW_HOSTNAME}`) && (PathPrefix(`/category`)||PathRegexp(`^/article/.*$`)||PathPrefix(`/_next`)||PathPrefix(`/help`)||Path(`/robots/sitemap.xml`))"
      - "traefik.http.routers.helpcenter-router.priority=11"
      - "traefik.http.routers.helpcenter-router.entrypoints=web-secure"
      - "traefik.http.routers.helpcenter-router.middlewares=secure-headers,compression"
      - "traefik.http.routers.helpcenter-router.service=helpcenter"
      - "traefik.http.routers.helpcenter-router.tls.certresolver=letsencrypt"

Обновление

Выполните обновление с перезагрузкой системы:

docker compose pull
docker compose down
docker compose up -d

После обновления

После того, как все контейнеры запустятся и сервис станет доступен через веб-интерфейс, выполните пост-апгрейдные шаги:

1. Запустите команду пост-старт, чтобы обновить файлы статики, индексы поиска и выполнить другие необходимые процедуры:

docker exec --env-file .env -it swarmica-django-1 python manage.py post_start

Эта команда может занять долгое время, в зависимости от количества данных в системе.

2. Запустите команды восстановления шаблонов бота:

docker exec --env-file .env -it swarmica-django-1 python manage.py restore_bot_messages
docker exec --env-file .env -it swarmica-django-1 python manage.py restore_bot_messages -k greeting,ticket_closed

3. Запустите команду, которая перенесет для всех опубликованных статей текущие значения автора в редактора:

docker exec --env-file .env -it swarmica-django-1 python manage.py migrate_article_publisher

4. Запустите команду, которая исправит неверно сохраненные метрики:

docker exec --env-file .env -it swarmica-django-1 python manage.py aggregated_metric_ticket_status_duration 500
docker exec --env-file .env -it swarmica-django-1 python manage.py aggregated_metric_timelog 500

5. Запустите команду создания индекса поиска по значением кастомных полей тикета (это оптимизирует время поиска по списку тикетов):

docker exec --env-file .env -it swarmica-django-1 python manage.py update_aggregated_custom_fields

6. Если вы пользуетесь Нейропоиском для агентов, то запустите следующую команду, чтобы добавить черновики и непроверенные статьи в индекс ИИ-ассистента:

docker exec --env-file .env -it swarmica-django-1 python manage.py update_ai_assistant_search_index

7. Запустите очистку неиспользуемых данных:

docker system prune -a

✨ Основные улучшения

• 🤝 Интеграции и автоматизация
  • Поддержка сценариев для ботов мессенджеров и управление шаблонами сообщений
  • Исходящие вебхуки и почтовые сообщения
  • Механизм автоматических действий по событию и расписанию
  • Автоматизация скриптов с запуском по расписанию или триггерам (runtime scripts).
• 🤖 AI-агент
  • Виртуальный AI-агент в тикетах и чатах.
  • Настройка виртуального агента на конкретный канал и/или тикет/чат.
• 📚 Статьи и база знаний
  • Возможность связывать статьи с задачами в issue-трекерах и добавлять комментарии.
  • Отделение роли публикующего Редактора и Автора для статей.
• 🎨 UI и UX
  • Вставка и поиск шаблонов быстрого ответа по горячей клавише (#-вставка).
  • Экспорт тикета в PDF и HTML
  • Быстрая проверка дубликатов тикетов
  • Объединение нескольких тикетов в один
  • Возможность копировать вложения при форке тикета или комментария.
  • Возможность скачивать все вложения из комментариев одним кликом.
  • Денормализация кастомных полей тикетов для ускорения поиска.

🔧 Исправленные ошибки

• 🗄 Тикеты
  • Исправлены ошибки при очистке состояния выбранных тикетов.
  • Исправлены ошибки обновления названия организации и отображения статуса тикета.
  • Исправлена логика работы WhatsApp-бота
  • Исправлено отображение иконок, кнопок и скроллов в чатах (в т.ч. Firefox).
  • Исправлено поведение при создании комментариев из внешних трекеров.
• 📧 Email
  • Исправлена валидация email-адресов (нельзя использовать ; и ,).
  • Исправлена проверка отправителя с доменом разрешенных в CC
• 📚 Статьи и QA
  • Исправлена привязка ответственного при отвязке статьи от тикета.
  • Исправлена установка издателя при миграции статей.
  • Исправлен расчёт QA score (учёт правил и карт).
• 🛡 Права и роли
  • Роль Сотрудник может писать комментарии без учета обязательных кастомных полей
  • Исправлена логика возврата identity в OTP.
• 📊 Фильтры и поиск
  • Разделение uids и names в экспорте фильтров (Excel).

Инструкция

Подготовка

Для обновления проверьте, что в конфигурационном файле .env поставлена версия:

~# grep VERSION .env
SW_FRONTEND_VERSION=v5.1.3
SW_BACKEND_VERSION=v5.1.3

Обновление

Выполните обновление с перезагрузкой системы:

docker compose pull
docker compose up -d --remove-orphans
docker compose restart traefik

После обновления

После того, как все контейнеры запустятся и сервис станет доступен через веб-интерфейс, выполните пост-апгрейдные шаги:

1. Запустите команду пост-старт, чтобы обновить файлы статики, индексы поиска и выполнить другие необходимые процедуры:

docker exec --env-file .env -it swarmica-django-1 python manage.py post_start

Эта команда может занять долгое время, в зависимости от количества данных в системе.

2. Запустите команду восстановления шаблонов уведомлений о транскрипте чата, об упоминании пользователя и группы - устранена проблема с отображением HTML шаблона при упоминаниях пользователя или группы:

docker exec --env-file .env -it swarmica-django-1 python manage.py restore_email_templates -k ticket_chatmessage_public_transcript,ticket_user_mention,ticket_group_mention

3. Запустите команду, которая изменит условия проверки выполнения шага внедрения KCS в разделе KCS Dashboard:

docker exec --env-file .env -it swarmica-django-1 python manage.py restore_kcs_tree_nodes -u oc4pQPy4Dbq1Qnwm

4. Запустите команду, которая исправит неверно сохраненные условия сортировки списков тикетов, которые могли появиться из-за проблемы, устраненной в 5.1.х:

docker exec --env-file .env -it swarmica-django-1 python manage.py fix_filter_ordering

5. Запустите очистку неиспользуемых данных:

docker system prune -a

✨ Основные улучшения

• 🩺 Healthcheck для интеграций — теперь есть глобальный API проверки состояния каналов (включая Billmanager и VK), который помогает вовремя выявлять неполадки.
• 📧 Email и уведомления
  • Сохранение ID сообщений для корректных заголовков In-Reply-To.
  • Логирование параметров запросов для прозрачности.
  • Возможность безопасно отклонять письма с подозрительными заголовками.
• 🔍 Поиск и фильтры
  • Поиск сотрудников по названию группы.
  • Логирование запросов на списки тикетов и пользователей.
• 📝 Документация и инструменты
  • Перевод API-документации на английский язык.
  • Документация по событиям статей, тикетов и пользователей.
• 🖊 Редактор и формы
  • Поддержка drag-and-drop любых файлов в редакторе статей.
  • Возможность изменять размер изображений и управлять галереей с клавиатуры.
  • Поддержка множественного выбора организаций, групп, лицензий и продуктов в фильтрах и правилах автоназначения.
  • Клиент теперь может переводить тикет в статус Solved при отправке комментария.
• 🎨 UI и UX
  • Автопрокрутка списков при подгрузке элементов навыков и пользователей.
  • Возможность отключить дефолтную группу в настройках.
• ⚡ Производительность и рефакторинг
  • Обновлён MDXEditor, Node.js до v22.
  • Масштабный рефакторинг API-запросов (тикеты, пользователи, каналы, QA, SLA, лицензии и др.).
  • Удалены устаревшие модули.

🔧 Исправленные ошибки

• 🗄 Тикеты и автоназначение
  • Создание правильных каналов тикетов при форке.
  • Исправлена логика назначения дефолтных групп.
  • Устранена возможность редактировать или объединять тикеты в статусах Closed и Deleted.
  • Добавлена поддержка массового закрытия и удаления тикетов.
• 💬 Чаты и уведомления
  • Исправлена отправка транскриптов только для тикетов с чатами.
  • Установлен правильный режим парсинга (HTML) для сообщений в Telegram.
  • Исправлена передача упоминаний пользователей/групп в чатах.
• 📧 Интеграции
  • Исправлены ошибки при синхронизации с GitLab и Billmanager.
  • Корректная обработка вложений и внешних ID для статей, организаций и лицензий.
• 🎨 Интерфейс
  • Исправлены отображения на больших экранах (страница KCS, заголовки списков, поля в таблицах).
  • Устранено наложение контролов на картинки в галерее.
• 📝 Редактор и фильтры
  • Исправлены ошибки переключения вкладок в редакторе статей.
  • Исправлено обнуление состояния KCS-статей после обновления тикета.
  • Исправлена работа dropdown в шаблонах Quill (автоскролл, обработка клавиш).
• 🔒 Роли и права
  • Добавлено ограничение на редактирование/клонирование фильтров активов только для Support-ролей.
  • Исправлена видимость элементов UI автоназначения для внутренних пользователей.

Инструкция

Подготовка

Для обновления проверьте, что в конфигурационном файле .env поставлена версия:

~# grep VERSION .env
SW_FRONTEND_VERSION=v5.0.1
SW_BACKEND_VERSION=v5.0.1

Обновление

Выполните обновление с перезагрузкой системы:

docker compose pull
docker compose up -d --remove-orphans
docker compose restart traefik

После обновления

После того, как все контейнеры запустятся и сервис станет доступен через веб-интерфейс, выполните пост-апгрейдные шаги:

1. Запустите команду пост-старт, чтобы обновить файлы статики, индексы поиска и выполнить другие необходимые процедуры:

docker exec --env-file .env -it swarmica-django-1 python manage.py post_start

Эта команда может занять долгое время, в зависимости от количества данных в системе.

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

docker exec --env-file .env -it swarmica-django-1 python manage.py calculate_article_links

3. Запустите команду перенастройки почтовых уведомлений в системе:

docker exec --env-file .env -it swarmica-django-1 python manage.py setup_email_notifications --update-existing

4. Если в системе используются функции ИИ, то необходимо запустить подсчет метрики потребления токенов:

docker exec --env-file .env -it swarmica-django-1 python manage.py aggregated_metric_token_consumption 120

Если ИИ не используется, то данную команду запускать не нужно.

5. Запустите очистку неиспользуемых данных:

docker system prune -a

🧠 AI-функции

• ✍ Перефразировка текста — сохранение нужного tone of voice в тикетах, статьях и чатах.
• ✅ Проверка текста (Proofread) — автоматическая корректура текста в тикетах, статьях и чатах.
• 🌐 Перевод ответов — на русский и английский языки (можно добавлять любые другие).
• 🔍 Автопоиск решения — при написании ответа выполняется поиск информации в «глобальном интернете».
• 📏 Сжатие и расширение текста — сокращение длинных или детализация коротких ответов.
• 🎯 Нулевая линия — автоматическая классификация входящих заявок и маршрутизация на агентов по навыкам и загрузке, с возможностью обучения.
• 🤝 Синергия с KCS
  • 💡 Автоматическое предложение решения клиенту ещё до создания заявки.
  • 🛠 ИИ-ассистент для агента — помощь в поиске узкоспециализированного решения в Базе знаний.
  • 📝 Автоматический анализ заявки и создание черновика статьи базы знаний.
  • 🔎 Проверка создаваемой статьи на возможные дубликаты.

✨ Основные улучшения

• 📦 Массовые действия с тикетами — обновление сразу нескольких заявок, уведомления о выполнении.
• ⚙️ QA: Конфигурируемые карточки наборов критериев для разных групп агентов.
• 🤖 Новые возможности автоназначения — правила по навыкам агентов, времени создания тикета, удобный выбор исполнителя.
• 📧 Работа с копиями (CC) — добавление и управление адресами копий при создании, обновлении и форке тикетов, в UI и через API.
• 🛑 Блокировка автоответов — возможность отключать автоматические ответы сторонних систем для предотвращения "битвы роботов".
• 💬 Цитирование комментариев — поддержка цитат в тикетах, в том числе в VK и Telegram.
• 🔗 Новые поля и типы данных — кастомное поле «ссылка», расширенные параметры форм тикетов.
• 📊 Статистика потребления AI-токенов с фильтрацией и экспортом.
• 🔍 Улучшенный фильтр и поиск — новые операторы поиска (по задачам/issues, организациям, навыкам, идентичности пользователей), удобный выбор пользователей в фильтрах.
• 🖱 Формы и кнопки — унифицированные кнопки сохранения/отмены в редакторах правил, фильтров, EULA.
• 🎨 UI и UX улучшения
  • Тёмная тема с поддержкой собственного логотипа и спиннера.
  • Отправка сообщений в чат по Ctrl/Cmd+Enter.
  • Подсветка синтаксиса Jinja2, поддержка Kotlin и YAML в редакторе кода.
  • Более удобное редактирование данных о пользователях, организациях и заявках.
  • Возможность копировать системные фильтры, автоматические правила и другие настройки.
  • Оптимизация скорости работы таблиц и редактора статей.

🔧 Исправленные ошибки

• ✅ Обновление статуса и мердж тикетов — исправлены проблемы с изменением статуса и логикой объединения заявок.
• 🔗 Поля и ссылки — корректное сохранение пользовательских полей, отображение ссылок и связанных статей.
• 👥 Автоназначение — исправлено поведение при изменении исполнителя системой.
• 💬 Работа с чатом
  • Устранено «скакание» курсора в Firefox.
  • Исправлена логика кнопок отправки сообщений.
• 🛡 Лицензии, фильтры и роли — корректная работа прав доступа и фильтров при различных настройках лицензий.
• 🌍 Локализация — исправлено отображение статей и переводов при смене языка.
• 📝 Редакторы — исправлены ошибки при подсветке синтаксиса в шаблонах писем и вставке ссылок.
• 🔄 Интеграции с Billmanager — исправлены ошибки синхронизации пользователей и тикетов.
• 📎 Вложения — исправлена обработка вложений и превью в массовых операциях.

Инструкция

Подготовка

Для обновления проверьте, что в конфигурационном файле .env поставлена версия:

~# grep VERSION .env
SW_FRONTEND_VERSION=v4.8.3
SW_BACKEND_VERSION=v4.8.3

Обновление

Выполните обновление с перезагрузкой системы:

docker compose pull
docker compose up -d --remove-orphans
docker compose restart traefik

После обновления

После того, как все контейнеры запустятся и сервис станет доступен через веб-интерфейс, выполните пост-апгрейдные шаги:

1. Запустите команду пост-старт, чтобы обновить файлы статики, индексы поиска и выполнить другие необходимые процедуры:

docker exec --env-file .env -it swarmica-django-1 python manage.py post_start

Эта команда может занять долгое время, в зависимости от количества данных в системе.

2. Запустите команду переноса сообщений чата в комментарии тикетов:

docker exec --env-file .env -it swarmica-django-1 python manage.py migrate_chat_messages

Если чаты не используются, то эту команду можно пропустить.

3. Запустите команду подсчета метрики трудозатрат:

docker exec --env-file .env -it swarmica-django-1 python manage.py aggregated_metric_timelog 365

Если не используется модуль учета трудозатрат, то эту команду можно пропустить.

4. После того, как все успешно обновлено и работоспособность проверена, можно удалить неиспользуемые данные docker для освобождения дискового пространства:

docker system prune -a

🆕 Основные улучшения в Swarmica 4.8.x

• Загрузка всех вложений одним кликом
• Новое событие 'SUBJECT_CHANGED' для заявок
• Автоназначение чатов по статусу агента
• Фильтры пользователей в модели чатов
• Фильтрация по категориям в шаблонах
• Вставка шаблонов сообщений в чат
• График трудозатрат
• Метрика трудозатрат в Аналитике
• HTML форматирование сообщений в чате
• Создание новой заявки по email при закрытии старой
• Поддержка цитирования комментариев в Telegram и WhatsApp
• Блок вложений в шаблонах уведомлений о создании заявки
• Документация по API генерации оценки качества
• Возможность создать события для оценки тикетов Проверяющими прямо сейчас
• Шаблоны для создания заявок
• Улучшения чата: комментарии, цитаты, упоминания
• Упоминания пользователей и групп в чатах
• Сущность Активы. Управление активами и их связь с тикетам
• Событие аудита при добавлении CC/BCC в тикете

🧠 ИИ бета*

• Поиск дубликатов статей

Бета-тестирование доступно по запросу.

🛠 Исправленные ошибки

• Добавлены внутренние ссылки на статьи в AI-подсказках
• Исправлен горизонтальный скролл в выпадающем списке
• Исправлена вставка изображений в чат
• Исправлена логика выбора ID организации в Яндекс.Трекере
• Исправлена ссылка на статью для клиента
• Исправления в форме шаблона заявки
• Исправлено отображение цитат в статьях
• Корректный пересчет SLA по недавно решенным заявкам
• Обработка ошибок в результатах AI и очистка старых данных
• Обработка ошибок с длинными названиями файлов вложений
• Исправлена ошибка 404 при удалении фильтра
• Скрытие кнопок редактирования и закрепления в закрытых заявках
• Улучшена обработка гонки триггеров при обновлении заявок
• Устранены лишние сигналы в миграциях сообщений
• Корректная передача комментариев в WebSocket
• Учитываются трудозатраты агентов, не назначенных на заявку напрямую
• Исправлена логика body overflow при модальных окнах
• Исправлен вывод булевых значений в полях заявки
• Единый вид кнопки "Добавить" для вложений и базы знаний

Инструкция

Подготовка

Для обновления проверьте, что в конфигурационном файле .env поставлена версия v4.7.2/v4.7.3:

~# grep VERSION .env
SW_FRONTEND_VERSION=v4.7.2
SW_BACKEND_VERSION=v4.7.3

Обновление

Выполните обновление с перезагрузкой системы:

docker compose pull
docker compose up -d --remove-orphans
docker compose restart traefik

После обновления

После того, как все контейнеры запустятся и сервис станет доступен через веб-интерфейс, выполните пост-апгрейдные шаги:

1. Запустите команду пост-старт, чтобы обновить файлы статики, индексы поиска и выполнить другие необходимые процедуры:

docker exec --env-file .env -it swarmica-django-1 python manage.py post_start

Эта команда может занять долгое время, в зависимости от количества данных в системе.

2. После того, как все успешно обновлено и работоспособность проверена, можно удалить неиспользуемые данные docker для освобождения дискового пространства:

docker system prune -a

🆕 Основные улучшения в Swarmica 4.7.x

Общие улучшения:

• Системные фильтры для модели чатов
• Навигация по изображениям в теле заявки
• Редизайн раздела продуктов
• Постраничный вывод в списке шаблонов
• Поддержка отображения номера версии продукта

🧠 ИИ бета*

• Поддержка ИИ-ассистента в настройках
• Предложения решений от ИИ при создании заявки
• Поддержка ИИ-подсказок для внутренних обращений
• Интерфейс и статистика для помощника «Предложить решение»
• Кнопка AI-поиска в комментариях
• Улучшение отображения токенов ИИ (по умолчанию — текущая неделя)
• Открепление статьи, предложенной ИИ
• Черновик статьи на основе переписки с ИИ
• Переименование флага функции для ИИ
• Улучшения логики автозаполнения и автоназначения с учётом ИИ

* Бета-тестирование доступно по запросу.

🛠 Исправленные ошибки:

• Корректное отображение тем обращений в таблице
• Улучшенная адаптивность интерфейса тикетов
• Исправлены стили чекбоксов и кнопок
• Исправлены ошибки фильтрации по продуктам в хелп-центре
• Повышена стабильность работы с внешним и внутренним контентом
• Исправлены ошибки синхронизации комментариев с биллинг-системой
• Исправлена обработка поисковых запросов и дубликатов
• Устранены ошибки форматирования текста при копировании
• Исправлены баги в работе API профиля пользователя и отображении ссылок
• Исправлено автоматическое назначение навыков в тикетах
• Улучшено поведение фильтров и сортировки в списках заявок
• Исправлены баги, связанные с работой справочников и версий продуктов

Быстрый старт

1. Создайте новую виртуальную машину из образа Swarmica
2. На вашей рабочей станции добавьте в /etc/hosts внешний IP этой виртуальной машины, указывающий на доменное имя vk-cloud.swarmica.com
3. Зайдите через браузер, используя следующие данные:

https://vk-cloud.swarmica.com
admin@swarmica.local
VK-Cloud!Swarmica

Смена доменного имени

Чтобы заменить доменное имя с vk-cloud.swarmica.com на ваше собственное, необходимо выполнить команду внутри виртуальной машины:

sudo make -f /root/swarmica/Makefile change-hostname HOSTNAME=my.new.hostname.tld

Смена пароля администратора

1. Зайдите в раздел Настройки > Управление сотрудниками
2. Найдите учетную запись администратора по почте admin@swarmica.local
3. Нажмите кнопку Задать пароль

Рекомендуется создать новую учетную запись в разделе Управление сотрудниками, а предустановленную учетную запись заблокировать.

Смена лицензии

1. Зайдите в раздел Настройки > Лицензия Swarmica
2. Загрузите новый лицензионный ключ

Для дальнейшей настройки обратитесь к пошаговому руководству:
Первоначальная настройка Swarmica

Быстрый старт

1. Создайте новую виртуальную машину из образа Swarmica
2. На вашей рабочей станции добавьте в /etc/hosts внешний IP этой виртуальной машины, указывающий на доменное имя yandex-cloud.swarmica.com
3. Зайдите через браузер, используя следующие данные:

https://yandex-cloud.swarmica.com
admin@swarmica.local
YCloud!Swarmica

Смена доменного имени

Чтобы заменить доменное имя с yandex-cloud.swarmica.com на ваше собственное, необходимо выполнить команду внутри виртуальной машины:

sudo make -f /root/swarmica/Makefile change-hostname HOSTNAME=my.new.hostname.tld

Смена пароля администратора

1. Зайдите в раздел Настройки > Управление сотрудниками
2. Найдите учетную запись администратора по почте admin@swarmica.local
3. Нажмите кнопку Задать пароль

Рекомендуется создать новую учетную запись в разделе Управление сотрудниками, а предустановленную учетную запись заблокировать.

Смена лицензии

1. Зайдите в раздел Настройки > Лицензия Swarmica
2. Загрузите новый лицензионный ключ

Для дальнейшей настройки обратитесь к пошаговому руководству:
Первоначальная настройка Swarmica

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

Шаг 1. Основные настройки

Настройте языки, валюту и конфигурацию Email.

Перейдите в раздел Настройки в боковом меню и выберите раздел Настройки Swarmica.

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

Подробнее о глобальных настройках можно прочитать здесь.

Шаг 2. Подключение исходящей почты

Подключите корпоративный почтовый ящик, с которого будут отправляться ответы по Email.

Перейдите в раздел Настройки и нажмите на блок SMTP relay.

Откроется страница с настройками. Ниже показываем пример заполненных настроек.

Сверху вниз внесите следующие данные:

1. Адрес вашего почтового сервера.
2. Порт для исходящей почты вашего сервера.
3. Имя пользователя, через которого будет проходить исходящая почта.
4. Пароль пользователя.
5. Шифрование: нет, SSL или TLS.
6. Активируйте переключатель Включен, если все настройки внесены, и сервер готов к работе.
7. Нажмите Проверить настройки, чтобы убедиться, что всё корректно работает.

Шаг 3. Подключение входящей почты

1. Перейдите в Swarmica в раздел бокового меню Настройки, выберите Каналы, нажмите Email.

2. Справа вверху нажмите

3. Откроется окно для заполнения основных данных:

Название - произвольное название вашего почтового канала.

Получатель - адрес email, на который вы получаете почту.

Отправитель - адрес, с которого вы будете отвечать на письма.

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

После заполнения основных данных нажмите

4. Откроется страница настроек почты. Заполните её данными вашего почтового клиента и прочими настройками по образцу.

Следующие бегунки должны быть включены:

• Использовать системный SMTP сервер (его настраивали на предыдущем этапе). Если ваши настройки отличаются от предыдущего этапа, и вы не используете системный SMTP сервер, то бегунок не включайте, а внесите эти настройки, см. подробности о них в отдельных статьях в следующем абзаце.
• Разрешить создание заявок.
• Включен.

Подробности настроек вы можете увидеть в отдельных статьях:

• Yandex
• Gmail
• Mail.ru

Шаг 4. Создание сотрудников

Чтобы создать сотрудника, нажмите в правом верхнем углу раздела Настройки - Управление сотрудниками.

После нажатия на Создать откроется выбор:

Мы рекомендуем по стандартной процедуре пригласить пользователя. В этом случае сотруднику отправляется на почту специальное приглашение, он переходит по ссылке и сам вводит свои данные и пароль. Ссылка действительна 24 часа!

С выбором этого способа создания сотрудника открывается такое окно:

Нужно ввести email пользователя, выбрать его роль и нажать . После этого приглашение отправится пользователю.

Альтернативный вариант - создать карточку пользователя самостоятельно, выбрав по нажатию кнопки Создать вариант Создать пользователя. В этом случае вы самостоятельно задаёте его имя, логин и пароль.

Сотрудникам, которые будут работать с обращениями клиентов, задайте роль "Агент".

Подробнее об управлении сотрудниками вы можете прочитать здесь.

Шаг 5. Подключение telegram-бота

Перейдите в Swarmica в раздел Настройки - Каналы и выберите Telegram. На открывшейся странице нажмите Создать вверху справа.

Введите название канала, на которое вам удобно будет ориентироваться при обработке заявок и нажмите

Откроется страница настроек:

Прежде всего, сюда нужно ввести токен вашего бота. Его можно найти в сообщении, которое пришло вам в ответ на успешно добавленный никнейм бота в чате с BotFather.

Для быстрой обработки заявок из мессенджеров рекомендуем выбрать Создавать - Чаты.

Активируйте бегунок Включен, чтобы канал заработал, и сохраните настройки:

Подробности подключения читайте здесь.

Шаг 6. Группы пользователей

Пользователей-сотрудников можно разбить по группам для дальнейшего распределения обращений и разграничения статистики.

1. Перейдите в Настройки - Управление группами.
2. В правом верхнем углу нажмите на кнопку Создать новую.
3. Введите название группы. Например, "1 линия" или "Инженеры".
4. Нажмите кнопку Сохранить.
   Откроется такое окно.
   
5. В правом блоке нажмите Добавить сотрудника и начните вводить его имя, выберете из предложенного списка нужного пользователя для добавления. Присутствие пользователей в конкретной группе позволяет разграничить работу с тикетами в нужной группе, а также группировать статистику по выбранным группам.
6. Остальные опции можно пока оставить нетронутыми.
7. Нажмите Сохранить для сохранения изменений.

Подробнее об опциях группы можно прочитать здесь.

Шаг 7. Создание фильтров заявок

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

Фильтры в списке заявок выглядят так:

Чтобы добавить и настроить системные фильтры, нажмите Настройки в боковом меню, и затем Управление фильтрами.

Справа вверху нажмите и выберите Заявки. Откроется окно настройки фильтра.

Для области видимости выберите одну, несколько или все роли сотрудников, которым будет доступен фильтр.

Поля - отображаемые колонки в списке заявок.

Условия - сами фильтры, которыми будут выбираться нужные для отображения заявки.

Сортировка - параметр, по которому будут сортироваться заявки.

Подробнее об управлении фильтрами можно прочитать здесь.

Шаг 8. Автоназначение заявок

Теперь можно настроить автоматическое распределение заявок по группам и пользователям.

Для этого перейдите в раздел Настройки - Автоназначение заявок.

Здесь вы можете создать разные правила для назначения входящих заявок в разные группы. Правила создаются по принципу "Если (условие 1), то поместить в группу (группа) и назначить сотрудника, удовлетворяющего условию (условие 2). Создав несколько таких правил, можно настроить их порядок работы. Правила в списке правил работают сверху вниз. Если первое правило не определило подходящего для новой заявки сотрудника, система применяет для заявки следующее правило, и так до тех пор, пока условие в каком-либо правиле не будет соблюдено. Кроме того, вы можете настроить режим периодического перераспределения заявок - он позволит периодически обновлять для правил информацию о доступности сотрудника в настоящий момент.

Чтобы создать новое правило, нажмите в правом верхнем углу раздела. Откроется окно создания правила. Вот пример заполненного окна.

Правило будет добавлено в список Доступные правила. Чтобы оно начало работать, перенесите его в список Действующие правила нажатием на + возле его названия:

Не забудьте сохранить изменения кнопкой в правом нижнем углу окна.

Подробнее о работе с правилами автоназначения можно прочитать здесь.

Шаг 9. Подключение трекера задач

К Swarmica можно подключить трекер задач для связывания задач с заявками. На данный момент доступны к подключению следующие трекеры:

• Yandex Tracker
• Jira
• Gitlab
• Youtrack

По запросу подключается:

• Kaiten

При работающей интеграции на странице заявки можно осуществить поиск по задачам в трекере при помощи поля поиска в правом верхнем углу страницы заявки. По ключевым словам находится задача:

Если задача имеет ключевое отношение к заявке, сотрудник прикрепляет задачу к заявке опцией Добавить в заявку.

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

Для интеграции с вашим трекером перейдите в настройки системы в боковом меню и выберите Трекеры задач.

На открывшейся странице нажмите на название вашего трекера.

Откроется страница с полями для заполнения. Заполните их данными трекера. Поясним значение общих полей:

1. Дополнительные поля - опциональные поля из трекера, которые должны содержаться в задаче для её передачи в Swarmica.
2. Таймаут - временной промежуток в секундах, в течение которого Swarmica будет обращаться к трекеру при отсутствии моментального ответа. По умолчанию 30 секунд, менять этот параметр не рекомендуется, за исключением особых требований вашего девопса или сетевого администратора.
3. Активен - включите бегунок для активации интеграции.

О том, как заполнять поля с данными трекера, мы подробнее рассказали в отдельной статье.

Системные требования

ВНИМАНИЕ! Сервер может быть виртуальным, но только на технологиях гипервизорной виртуализации. Установка и запуск внутри гостевой ОС на контейнерной платформе виртуализации не поддерживается

ОС

Поддерживаемые версии ОС:

• Alt Server 11.1 (Альт Сервер 11.1)
• Astra Linux 1.8
• RedOS 8 Стандартная
• RedOS 8 Сертифицированная
• Ubuntu 26.04.x LTS
• Ubuntu 24.04.x LTS
• Ubuntu 22.04.x LTS (рекомендуется перейти на более новые версии)

Минимальные

Минимальные требования для запуска приложения и его функционального тестирования:

CPU: 4 vCPU (Intel Core i5 / Xeon)
RAM: 16 GB
HDD: 50 GB SSD

Рекомендованные

Для рабочих режимов эксплуатации:

CPU: Intel Xeon / i7 8 Core
RAM: 32 GB
HDD: 500GB SSD (желателен RAID массив)

Требования к инфраструктуре

Исходящий трафик

С сервера, на который будет устанавливаться продукт, необходим доступ до следующих ресурсов:

• https://reg.gl.swd.im - реестр образов контейнеров для приложения
• https://license.swarmica.com - сервер лицензионных ключей Swarmica
• https://mirror.gcr.io - зеркало реестра образов контейнеров для связанных сервисов, таких как redis, postgres, traefik и т.д.
• Зеркала или репозитории пакетов для ОС Ubuntu, настроенные на сервере

Если будет использоваться SMTP Relay для исходящей почты, то он также должен быть доступен с сервера приложения.

Входящий трафик

• Порты 80 и 443 - для WEB интерфейса
• Порт 25 - если будет использоваться входящий канал электронной почты через SMTP

DNS

• Выбранное доменное имя должно разрешаться во внешний IP адрес системы (запись A типа)

Пример:

Для того, чтобы система была доступна по адресу support.swarmica.com, установленном на сервере с IP адресом 79.141.74.181 и нужно добавить следующие записи в DNS:

support.swarmica.com   A      79.141.74.181

Входящая почта

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

• Адрес сервера
• Порт (993)
• Пользователь (обычно тот же, что и адрес почты, например, support@company.tld)
• Пароль (обычно тот же, что и для пользователя, за исключением почты на сервисах Gmail, Yandex Mail, Mail.ru - там требуется создать пароль приложения)

Исходящая почта

Для отправки исходящей почты требуется настроить SMTP Relay - авторизованный SMTP сервер, который будет пересылать почту из системы внешним получателям.

Поддерживаются протоколы:

• SMTP (25)
• SMTP SSL (465)
• SMTP TLS (587)

Лицензия

Получите у представителя Swarmica следующие данные, необходимые для корректного запуска системы:

• Лицензионный ключ Swarmica
• Данные учетной записи для реестра образа контейнеров (логин и токен доступа)

Установка

1. Скачайте архив на сервер, где планируется установка:

mkdir swarmica-installer
cd swarmica-installer
wget https://support.swarmica.com/attachments/installer/installer.tar.gz

2. Распакуйте архив подходящей утилитой:

tar -xvzf installer.tar.gz

3. Добавьте пермиссий на выполнение:

chmod +x installer.sh

4. Запустите установку:

./installer.sh install

Помощь: ./installer.sh help

Запуск в режиме DEBUG: export DEBUG=1; ./installer.sh install