We strongly recommend that every installation runs the most recent production release of LabKey Server at all times. Upgrading regularly ensures that you are operating with all the latest security, reliability, and performance fixes, and provides access to the latest set of LabKey capabilities. LabKey Server contains a reliable, automated system that results in a very easy upgrade process.

Recognizing that some organizations can't upgrade immediately after every LabKey production release, we've adopted the following upgrade policy:

  • We support upgrading from production releases for two years after their initial release. For example, any installation running v14.3 (Nov, 2014 release) or later official releases should be able to upgrade to v17.1; earlier releases (v14.2 and before) will not be able to upgrade directly to v17.1.
  • We especially discourage running "interim development builds" (builds from the development process that are not production releases) in any production environment. Interim builds are not fully tested and are sure to contain bugs and incomplete features; they should be upgraded to a production release ASAP. We try to support upgrading from interim development builds for two production releases. For example, v17.1 should be able to upgrade from any interim build created after the v16.2 production release.
This policy should easily accommodate all serious users of LabKey Server. Putting some minor limits on upgrade scenarios allows us to retire old migration code, streamline SQL scripts, and focus testing on the most common upgrade scenarios.

The table below shows the upgrade scenarios supported by past and future (*) releases of LabKey Server:

LabKey ReleaseCan Upgrade From These Official ReleasesCan Upgrade From These Interim Releases
17.2*15.1 and later16.3 and later
17.1*14.3 and later16.2 and later
16.314.2 and later16.1 and later
16.214.1 and later15.3 and later
16.113.3 and later15.2 and later
15.313.2 and later15.1 and later
15.213.1 and later14.3 and later
15.112.3 and later14.2 and later
14.312.2 and later14.1 and later
14.212.1 and later13.3 and later
14.111.3 and later13.2 and later
13.311.2 and later13.1 and later
13.211.1 and later12.3 and later
13.110.3 and later12.2 and later
12.310.2 and later12.1 and later
12.210.1 and later11.3 and later
12.19.3 and later11.2 and later
11.39.2 and later11.1 and later
11.29.1 and later10.3 and later
11.18.3 and later10.2 and later
10.38.2 and later10.1 and later

If you have questions or find that this policy causes a problem for you, please contact LabKey for assistance.





expand all collapse all