This chart summarizes server-side dependency recommendations for past & current releases, and predictions for upcoming (*) releases.
| Recommended: fully supported and thoroughly tested with this version of LabKey | |
| Use with caution: either deprecated or not fully supported/tested yet on 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 16.2 (July 2016) | LabKey 16.3 (Nov 2016) | LabKey 17.1 (Mar 2017) | LabKey 17.2* (July 2017) | LabKey 17.3* (Nov 2017) |
|---|---|---|---|---|---|---|
| Java | 8.x | |||||
| Tomcat | 8.5.x | |||||
| 8.0.x | ||||||
| 7.0.x | ||||||
| PostgreSQL | 9.6 | |||||
| 9.5 | ||||||
| 9.4 | ||||||
| 9.3 | ||||||
| 9.2 | ||||||
| Microsoft SQL Server | 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. We understand that this is not always possible, so 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. For the latest versions of these browsers, 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.
LabKey Server requires Java 8. We strongly recommend using the latest Java 8 runtime from Oracle, currently Java SE 8u121.
LabKey Server no longer supports Java 7 due to Oracle ending public updates of Java 7 (see Oracle Java SE Support Roadmap). LabKey Server has not been tested with non-Oracle Java implementations (e.g., OpenJava, OpenJDK, IBM J9, etc.).
We recommend using the latest release of Apache Tomcat 8.5.x (currently 8.5.12). Due to a recently fixed Tomcat issue, do not use 8.5.8 or earlier.
LabKey continues to support Tomcat 8.0.x and 7.0.x, though here also we strongly recommend installing the latest point release (currently 8.0.42 or 7.0.76).
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 release of PostgreSQL 9.6.x (currently 9.6.2).
For those who can't transition to 9.6 yet, LabKey continues to support PostgreSQL 9.5, 9.4, 9.3, and 9.2, though here also we strongly recommend installing the latest point release (currently 9.5.6, 9.4.11, 9.3.16, and 9.2.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 2016. LabKey continues to support and test on SQL Server 2014 and 2012. LabKey does not support SQL Server 2008 R2 or earlier releases.
| previousnext |
| expand allcollapse all |
