3.15.2 Release Notes#

Squirro 3.15.2 was released on March 4, 2026.

Learn more about the Squirro Release Process.

Notes for administrators

This release introduces important changes that may require adjustments to your existing setup. Learn more

Improvements#

  • Extended file upload support for additional Office and text-based document formats.

  • Enhanced user permission validation to apply a role-based fallback when project permissions exceed the scope of the user role.

  • Added an all-permissions matching method to improve the accuracy of permission validation.

  • Added the ability to rename items collections.

  • Improved validation for asset and widget endpoints and added boolean type conversion for query parameters.

  • Updated the MySQL connection charset from utf8 to utf8mb4 to match the table encoding and ensure full Unicode support.

Bug Fixes#

  • Single-page PDFs not handled correctly when using the retriever with image reasoning in Squirro Chat.

  • /var/log/squirro/topic/stderr.log growing continuously due to DeprecationWarning messages in wsgiservice-based services.

  • Item details loading indefinitely when the chat widget was opened directly from a URL.

  • Chat not functioning correctly with RSS data sources.

  • Context variable propagation in asynchronous executor calls affecting tracing.

  • Semantic search plugin not correctly handling the TERMS array filter syntax.

  • Index Manager /cluster/health endpoint not responding correctly.

  • Double quotes not escaped when applying a facet filter from the Labels widget.

  • Incorrect interpolation of encrypted configuration values.

  • Collection update operations not returning the correct 409 status code when a collection with the same name already exists.

  • World Map widget crashing when the map component was not yet initialized.

  • Data loading failures when using the Squirro connector with instances running a version prior to 3.15.1.

  • Chat with Document feature missing the item ID when dashboard selections were active.

  • Parent item not always cleaned up from the index and neither retried nor moved to a failed batch when sub-items failed to index.

Known Issues#

  • In specific scenarios, cross-lingual information retrieval for semantic search may deliver lower-than-expected quality (SQ-28171).

  • An error may occur when chatting with an uploaded .pptx file in Squirro Chat (SQ-31480).

Breaking Changes#

  • Removed string support for project_permissions in SquirroClient.new_grant. The method now raises a ValueError if a non-list value is provided.

Installation and Upgrade#

For new installations, find step-by-step instructions on the Install and Manage Squirro with Ansible page (recommended) and Installing Squirro on Linux pages.

To upgrade an existing installation, see the Upgrading Squirro page.