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|
|Use with caution: either deprecated or not yet fully supported / tested 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)|
|Microsoft SQL Server||2017|
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.
Starting with 18.3, we recommend deploying on Java 11. We test primarily on Oracle OpenJDK, Oracle's production-ready open-source build of the Java Development Kit. We also support the commercial Oracle Java SE, though we caution that Oracle now requires a paid subscription for any use of the commercial runtime. In either case, we strongly recommend using the latest point release, currently 11.0.2. We also recommend that you familiarize yourself with recent changes to the Java licensing and release schedule that affect every LabKey deployment; see this post on the LabKey blog.
We continue to support the Oracle Java SE 8 runtime, currently 8u202. However, given the new Java rapid release cadence, public support for Java 8 ended January 2019; as a result, LabKey Server will no longer support Java 8 as of 19.1.
LabKey Server has not been tested with non-Oracle Java distributions such as AdoptOpenJDK, Amazon Corretto, Red Hat, Zulu, OpenJ9, etc.
We recommend running on a 64-bit operating system, and using a 64-bit Java distribution. Among other benefits, this ensures sufficient memory is available for a production installation.
We recommend using the latest point release of Apache Tomcat 9.0.x (currently 9.0.16).
LabKey continues to support older versions 8.5.x and 7.0.x, though we strongly recommend installing the latest point release of each (currently 8.5.38 or 7.0.92); older point releases have major compatibility issues and security vulnerabilities. Note that Tomcat 7.0.x is not compatible with some advanced features of LabKey Server (e.g., Docker and RStudio integration). Tomcat 8.0.x is no longer supported as it has reached end of life; it has been superseded by Tomcat 8.5.x.
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 11.x (currently 11.2). Do not use PostgreSQL 11.0; it was released with a serious bug that makes 11.0 incompatible with many applications.
For those who can't transition to 11.x yet, LabKey continues to support PostgreSQL 10.x, 9.6.x, 9.5.x, and 9.4.x, though here also we strongly recommend installing the latest point release (currently 10.6, 9.6.11, 9.5.15, and 9.4.20) 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 database.
For installations using Microsoft SQL Server as the primary database, we recommend using Microsoft SQL Server 2017, which we've tested on both Windows and Linux. We continue to support and test on SQL Server 2016, 2014, and 2012. LabKey does not support SQL Server 2008 R2 or earlier releases.