This chart summarizes server-side dependency recommendations for past & current releases, and predictions for upcoming releases.
Do not use: not yet available or tested with this version of LabKey | |
Recommended: fully supported and thoroughly tested with this version of LabKey | |
Upgrade ASAP: deprecated and no longer supported with this version of LabKey | |
Do not use: incompatible with this version of LabKey and/or past end of life (no longer supported by the organization that develops the component) |
Component | Version | LabKey 19.3.x (Nov 2019) | LabKey 20.3.x (Mar 2020) | LabKey 20.7.x (Jul 2020) | LabKey 20.11.x (Nov 2020) | LabKey 21.3.x (Mar 2021) |
---|---|---|---|---|---|---|
Java | Java 15 | |||||
Java 14 | ||||||
Java 13 | ||||||
Tomcat | 9.0.x | |||||
8.5.x | ||||||
PostgreSQL | 12.x | |||||
11.x | ||||||
10.x | ||||||
9.6.x | ||||||
9.5.x | ||||||
Microsoft SQL Server | 2019 | |||||
2017 | ||||||
2016 | ||||||
2014 | ||||||
2012 |
LabKey Server requires a modern browser for many advanced features, such as locking data table column headers in place when scrolling, creating charts, or visualizing security group relationships. To take advantage of all features, we recommend upgrading your browser(s) to the latest release. Since this is not always possible, the LabKey team attempts to maintain basic compatibility and fix major issues with the following browsers:
As a general rule, LabKey Server supports the latest version of the browsers listed above. To review and download the latest versions, click the links provided.
If you experience a problem with a supported browser feel free to post the details to the support forum so we're made aware of the issue.
We recommend using the latest point release of AdoptOpenJDK 14 64-bit (x64) with HotSpot JVM (currently 14.0.2+12), the community-supported production-ready distribution of the Java Development Kit. LabKey continues to support Oracle OpenJDK, Oracle's open-source build of the JDK, and AdoptOpenJDK 13 with HotSpot JVM, though note that public updates (i.e., patches to address security and reliability issues) are no longer provided for JDK 13.
LabKey Server has not been tested with other Java distributions such as the Oracle commercial Java SE, Amazon Corretto, Red Hat, Zulu, OpenJ9, etc.
We recommend using the latest point release of Apache Tomcat 9.0.x (currently 9.0.37).
LabKey continues to support older version 8.5.x, though we strongly recommend installing the latest point release (currently 8.5.57); older point releases have major compatibility issues and security vulnerabilities. Support for Tomcat 7.0.x has been removed since this version has been slated for end-of-life by the Tomcat team.
We recommend installing Tomcat using the binary distributions; if a package manager is used, the lib directory may be installed in a different location. Also, the packages sometimes include alternative versions of some components (like JDBC connection pools) that can cause incompatibilities.
We recommend not using the Apache Tomcat Native library; this library can interfere with SSL and prevent server access via LabKey's client libraries.
For installations using PostgreSQL as the primary database, we recommend using the latest point release of PostgreSQL 12.x (currently 12.3).
For those who can't transition to 12.x yet, LabKey continues to support PostgreSQL 11.x, 10.x, 9.6.x, and 9.5.x, though here also we strongly recommend installing the latest point release (currently 11.8, 10.13, 9.6.18, and 9.5.22) to ensure you have all the latest security, reliability, and performance fixes.
PostgreSQL provides instructions for how to upgrade your installation, including moving your existing data.
For installations using Microsoft SQL Server as the primary database, we recommend using Microsoft SQL Server 2019, which we've tested on both Windows and Linux.
LabKey continues to support SQL Server 2017, 2016, 2014, and 2012. LabKey does not support SQL Server 2008 R2 or earlier releases.