3.17.0 Release Notes#

Squirro 3.17.0 was released on September 3, 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#

AI#

  • Create New Chat available in the Chat widget sidebar on projects with no indexed data.

  • File Upload and other tools configured on the Chat With LLM agent now take effect.

Platform#

  • Data source credentials write-only once saved, shown as “Stored” with a Replace action, and never included when duplicating a source.

  • Settings of a data source with stored credentials editable without re-entering the credential.

  • External ID label on the mapped ID column in the data source field-mapping step, with a link to the item format documentation.

  • Real values of the source ID column shown in the Data Preview of the data source wizard.

  • Smaller PDF viewer assets, with unused Office-conversion components removed.

  • Member workspace roles editable by workspace admins, in addition to cluster admins.

  • Spaces menu available to Project Readers on instances using workspaces, making the Home page reachable.

  • Newer nginx releases installable, with the platform packages no longer pinning a minimum version.

  • Database connector connection string treated as a credential, with connector credentials kept out of log output.

  • Monitoring metrics endpoint serving Squirro application metrics only, without operating-system metrics.

Bug Fixes#

  • Opening a dashboard URL for a project you cannot access logging you out.

  • Project Translations silently discarding a row with an empty or whitespace-only key, keeping surrounding spaces in keys, and dropping the warning when a save failed.

  • Editing a label not saving a group typed directly into the Group field, and reporting success when the group was empty.

  • Edited label values not immediately shown in the Labels grid.

  • Project Settings Properties not reporting why a save failed, showing the unsaved project name in the navigation, and identifier copy and image controls not keyboard-accessible.

  • Sorting the Data Ingestion Logs table by Body or another content column emptying the view.

  • Data source preview failing for the database connector when using an inline SQL query.

  • PDF viewer not releasing browser resources when a document was closed.

  • Spaces menu failing to open for readers with no other accessible project.

  • Dashboards entry not highlighted as the current space for readers.

  • Dropbox data source using the previous access token after re-authentication with a different account or scope.

  • Squirro and GenAI metrics missing from Prometheus monitoring.

Breaking Changes#

  • Tools configured on the Chat With LLM agent take effect on existing projects after upgrading, where they were previously ignored. Review the tools turned on for that agent before upgrading.

  • The monitoring health check endpoint returns 503 when a platform service is down, where it previously returned 200. Check any load balancer or automated check that reads it.

  • Data source connector credentials are write-only. Data source responses carry a secret_fields map that reports only whether each credential is set. Update any integration that reads credentials back from a data source configuration.

  • Users with the reader role can no longer preview a saved data source that has credentials. Readers can still preview a configuration they supply themselves. Users with the member role and above are unaffected.

  • .sqproj project exports no longer contain connector credentials for exported data sources. Enter the credentials again for each data source after importing a project.

  • The counts_agg parameter of the data sources API accepts only status and plugin_name. Update any client that passes another attribute.

Project Neo#

Technical Preview | Learn more

Improvements#

  • Project-wide events stream scoped to the conversations of the calling user, with Last-Event-ID resuming after the given cursor.

  • User settings opening in a dialog layered over the current page.

  • Pastes of 4,096 characters or more converted into an editable text attachment.

  • Attachments rendered as a card showing the file contents, opening a preview and editor.

  • Response duration shown in the Response details panel.

  • Text selection actions Copy, Quote, Explain and Translate available in chat answers.

  • Connectors dropdown showing Connect alone for per-user OAuth servers that are not yet connected.

  • Topics dashboard removed from the Project Neo interface.

  • Experimental batch Q&A removed from the Project Neo interface.

Bug Fixes#

  • Aborted chat streams leaving blocks spinning and hiding the completed answer until a reload.

  • Conversations opened from history starting at the top of the transcript.

  • Citation badge tooltip flickering when the cursor entered the badge from above.

  • Long unbroken strings not wrapping in the question bubble and the answer.

  • Long task names overflowing the task card and colliding with the row actions.

  • Side panel staying open and the conversation staying highlighted after leaving a conversation.

  • Low-contrast filter hint in the template grid empty state in light mode.

  • Low-contrast project description, search controls and chevron in the project selector in light mode.

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.