# 3.17.0 Release Notes Squirro 3.17.0 was released on September 3, 2026. Learn more about the [Squirro Release Process](../squirro-release-process.md#getting-squirro-process). > **Notes for administrators** > > This release introduces important changes that may require adjustments to your existing setup. [Learn more](#breaking-changes) ## 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](../../../technical/neo/index.md#neo) ### 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](../../install/ansible/index.md#ansible) page (recommended) and [Installing Squirro on Linux](../../install/linux.md#install-linux) pages. To upgrade an existing installation, see the [Upgrading Squirro](../../install/upgrade.md#install-upgrade) page.