Instructions

Preparation

To update, check that the version is set in the .env configuration file:

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

Remove the cron container from the services section of docker-compose.yml and the swarmica_cron_d volume from the volumes section and all services:

volumes:
  swarmica_postgres_data: {}
  swarmica_postgres_data_backups: {}
  swarmica_static: {}
  swarmica_logs: {}
  swarmica_ugc: {}
  swarmica_ai_assistant: {}
  swarmica_uploads: {}
  swarmica_runtime: {}
#  swarmica_cron_d: {} This line needs to be removed
  traefik_data: {}

services:
  django: &django
    ...
#      - swarmica_cron_d:/swarmica/swarmica/cron_d/:z This line needs to be removed

# This section needs to be removed entirely
#  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"

Update

Perform the update with a system reboot:

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

After the update

After all containers start and the service becomes available through the web interface, perform post-upgrade steps:

1. Run the post_start command to update static files, search indexes, and perform other necessary procedures:

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

2. Run the command to save the order of menu items in the custom fields Menu and Badge:

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

3. Run the command to create periodic tasks for collecting email via IMAP:

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

4. Run the command to recalculate the number of ticket links associated with articles:

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

5. If you use the Yandex AI provider, then run the following command:

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

6. Run the command to create template cards for AQI (Article Quality Index) checks:

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. Run the command to create template cards for LAI (Link Accuracy Index) checks:

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. Run the cleanup of unused data:

docker system prune -a

✨ Main Improvements

🤖 AI

• ⚡️⚡️⚡️ Added support for own (local) LLM through OpenAI API
• Added support for new AI providers:
  • ChatGPT
  • DeepSeek

📊 Reports and Automations

• Added new event time interval select modifiers.
• Added the group_rows parameter for row grouping in reports.
• Added a circuit breaker mechanism when trying to build too large a report.
• Improved sorting and display of search results.
• Added descriptions for auto-assignment rules.

🧠 Quality Control

• Implemented full management of your own rules for evaluating Link Accuracy and Article Quality Index.
• Refactored sections for evaluating Quality Control, Link Accuracy, and Article Quality Index - added filters, sortings, and search.

📩 Omnichannel

• Added support for Telegram working through a proxy server.
• Improved the reliability of email channel operation with an unstable network connection.

🎨 Interface and UX

• Added support for mass update of articles.
• Added the ability to delete article localization.
• Added the ability to drag-and-drop sort items in custom fields of type Menu or Badge.
• The ability to collapse long comments has appeared.

🔧 Fixed bugs

• 🎨 Fixed layout, attachment, and comment display issues.
• 🧾 Fixed race condition when updating tickets, SLA, and fork operations.
• 💬 Improved stability and expanded coverage of Swarmica installer scenarios
• ⚙️ Increased stability of background tasks, caching, and AI Assistants.
• 🧩 Fixed issues with generating article revisions and updating attachments.