MCP OAuth 2.0 Sign-In - MCP clients such as Claude Desktop or ChatGPT Desktop can connect to the LabKey MCP through standard OAuth 2.0 authorization. Sign in to LabKey Server through your browser, with no API key to copy, and review and revoke connected applications from the External Tool Access page.
SAML Email Attribute - SAML configurations can read the user's email address from an assertion attribute instead of the NameID. When your identity provider identifies users by an internal ID, LabKey accounts can still use real email addresses, so users receive email notifications. Update existing users' email addresses before turning this on.
LabKey SDMS: Community Edition Features
Performance at Scale - Common operations on large amounts of data are faster, including deleting many samples, creating workflow jobs with thousands of samples, and filtering and paging through large grids.
Full-Text Search Performance - Full-text search is faster, especially on servers with large numbers of containers. On deployments with thousands of folders and workbooks, full-text searches are up to 20x faster.
Import Column Conflict Check - Import stops with an error when more than one column in a file maps to the same field, so no imported values are dropped without warning. An import alias also can no longer take over a reserved field. Existing designs can still contain duplicate import aliases, or aliases that match reserved field names. Imports that used to succeed against these designs may now fail with this error until an administrator removes the conflicting alias.
Full-Text Search of Email and SAS Files - Full-text search now indexes email messages (.eml and mbox files) and SAS datasets (.sas7bdat files).
Wiki Subtree Delete Permissions - An Author can now delete a wiki subtree only if they created every page in it. Previously, an Author who created a parent page could delete its entire subtree, including pages created by other users. Editors and administrators can still delete any subtree.
Survey Design Permissions - Creating or editing a survey design now requires the Trusted Analyst or Platform Developer role (or higher), in addition to insert permission. Users who previously created survey designs with only Editor permissions will need one of these roles assigned.
File Times Shown in Server Time - Dates and times in the file browser, such as Last Modified, are now shown in the server's time zone, like dates elsewhere in LabKey Server. Previously they followed the time zone of the user's browser, so users in other time zones may see different times than before.
Calculated Fields in Folder Archives - Calculated fields on assay designs are now restored when a folder archive is imported. Calculated fields of any kind are exported with query metadata, so select Queries when exporting.
Link Expiration in Account Emails - Emails that invite new users, reset passwords, or confirm a new email address now tell users when their link expires. If you have customized any of these email templates, add the expiration notice to them.
System Upgrade Audit Log - The Audit Log now includes a System Upgrade Events entry showing when each server version change occurred, so administrators can correlate data or behavior changes with a specific upgrade.
API Key Descriptions in Login Audit Events - When an API key is used to log in, the User Events audit log records the key's description, so administrators can trace each API login to a specific key.
Query Dependency Report Scope - The Dependency Report is now always shown and states which folders it searched. Cross Folder Dependencies analysis defaults to the current project, shows its progress in a dialog that lets you stop it, and lists any errors at the end. The server also limits how many analysis requests it handles at once.
Hide/Show Search Icon - Hide or show the magnifying glass search icon in the page header.
Deprecated and Removed Features
Legacy Script Authentication Parameters Deprecated - Pipeline and transform scripts can no longer authenticate back to the server using the ${rLabkeySessionId}, ${httpSessionId}, or ${sessionCookieName} substitution parameters, or the LabKeyTransformSessionId session cookie. Use ${apikey} instead. A deprecated feature flag, "Allow script authentication via legacy substitution parameters," temporarily restores them while you migrate your scripts.
ExtJS 3.x Feature Flags Removed - The two ExtJS 3.x deprecated feature flags have been removed. Views, pages, and scripts that use Ext3 must declare this dependency explicitly.
Mutating SQL in GET Requests Feature Flag Removed - The "Allow GET requests to execute mutating SQL" deprecated feature flag has been removed. Actions can no longer run SQL that changes data in response to a GET request.
Disable Managed Trigger Columns Deprecated - The "Disable managed columns in query triggers" experimental feature has been moved to Deprecated Features and will be removed in a future release. Update trigger scripts that add or remove columns to declare them as managed columns.
Disable Enforce CSP Deprecated - The "Disable enforce Content Security Policy" experimental feature has been moved to Deprecated Features. Enabling it now displays a warning to administrators for as long as it remains turned on.
RowId Merge Experimental Feature Removed - The "Allow RowId to be accepted when merging samples or data class data" experimental feature has been removed.
Row-by-Row Update Experimental Feature Removed - The "Use row-by-row update" experimental feature has been removed.
RStudio ALB Strict Protocol Experimental Feature Removed - The "Use strict protocol match for redirects for dockerized RStudio with ALB" experimental feature has been removed. The AWS ALB redirect workaround for dockerized RStudio is now always on, which was already the default behavior.
MiniProfiler Removed - The MiniProfiler a developer tool has been removed.
Distribution Changes and Upgrade Notes
MariaDB External Data Source Support - LabKey now supports MariaDB as an external data source, in addition to MySQL. Going forward, LabKey uses the MariaDB JDBC driver to connect to both databases, and the MySQL driver has been removed. Existing MySQL and MariaDB external data source configurations in application.properties must be updated to use the new driver class name, url, and validation query, or the server will fail to start. The MariaDB driver connects using TLS by default; if your database server doesn't use TLS, add sslMode=disable to the url.
SAML Authentication Engine Upgrade - SAML single sign-on now uses Spring Security SAML2, a current, actively maintained library, in place of the previous OneLogin-based implementation. No configuration changes are needed, but administrators should test SAML sign-in after upgrading. If sign-in fails, a deprecated feature flag, "Use legacy SAML engine," temporarily restores the previous engine. Configurations that use the Transient NameID format now request the standard SAML 2.0 transient format. If your identity provider rejects sign-in with an InvalidNameIDPolicy error, update its NameID policy to accept it.
SAML Reauthentication Settings - The application.properties file distributed with LabKey Server now includes two commented-out properties, server.servlet.session.cookie.same-site and server.servlet.session.cookie.secure. On servers that use SAML and HTTPS, enable them so that users can reauthenticate in Chromium-based browsers, such as when signing ELN notebooks. Existing servers can add them to their application.properties file.
Assay Transform Script Timeout - A new site setting limits how long an assay transform or validation script can run, so a stalled script fails its import instead of holding it open indefinitely. The default is 60 minutes. Previously there was no limit, so if your transform scripts can run longer than an hour, raise the setting when you upgrade.
PostgreSQL 14.x Deprecated - Support for PostgreSQL 14.x is deprecated and will be removed in 27.3. The PostgreSQL team plans the final 14.x release for November 12, 2026, and will stop supporting this version after that. Upgrade to a newer version of PostgreSQL before upgrading to LabKey 27.3.
File Watcher Permissions - The user who creates a File Watcher must now have permission to impersonate its "Run as" user. This is checked every time the File Watcher runs, so a change to either user's permissions can cause the File Watcher to stop working.
Client APIs and Development Notes
importRows Requires the Same Fields in Every Row - The importRows API now rejects a request whose rows don't all supply the same fields. Previously, only the first row's fields were used, so values for any other field were silently dropped from later rows. Update clients to include every field in every row, sending null for missing values. A deprecated feature flag, "Allow importRows rows with differing fields," temporarily accepts mismatched rows while you update your clients. The insertRows, updateRows, and deleteRows APIs, file-based import, and Rlabkey's labkey.importRows are not affected.
Site Settings APIs - New APIs read and update site settings by name, so scripts can change a setting without using the Site Settings page. The Site Settings page no longer accepts form posts directly: scripts that posted to admin-customizeSite now get a 405 error and must use admin-updateSiteSettings.api instead.
Transform Scripts Run in Parallel - Transform scripts for concurrent imports now run at the same time, instead of one at a time. Scripts that assume they run alone, for example by sharing an external file or computing a new ID as "max ID + 1", may need changes. A script can also now call back into the server during an import, such as with selectRows, without risk of hanging the server. A run name (assayId) or comment (runComments) set by a script is now saved on the run.
Require Transform Scripts in @scripts or a Module - Transform scripts attached to an assay design must now be located in the design's container's @scripts directory, or supplied by a module. Referencing a script anywhere else now produces a validation error when the assay design is saved or a run is imported. A deprecated feature flag, "Allow assay transform scripts at arbitrary file system paths," provides a temporary way to skip this check while migrating.
Pipeline Job Deserialization Type Validation - Pipeline jobs and status messages are now validated against an allowlist of permitted classes when deserialized using Jackson and XStream, improving security. If a legitimate type is unexpectedly blocked, check the allowed list in 'PipelineJacksonTyping' or contact LabKey support. A deprecated feature flag, "Disable pipeline deserialization type allowlists," provides a temporary workaround if needed.
Null-Safe Comparison with IS DISTINCT FROM - LabKey SQL now supports the IS DISTINCT FROM and IS NOT DISTINCT FROM operators. Unlike = and !=, they never return NULL: two NULLs are considered equal (not distinct), so they're safe to use for comparisons that might involve NULL values.