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 17.3 (November 2017 release) or later official releases should be able to upgrade to 20.1.x; earlier releases (17.2 and before) will not be able to upgrade directly to 20.1.x.
  • We especially discourage running SNAPSHOT builds (aka, "interim development builds", builds from the development process that are not production releases) in any production environment. SNAPSHOT builds are not fully tested and are sure to contain bugs and incomplete features; they should be upgraded to a production release ASAP. We support upgrading from SNAPSHOT builds for only two production releases. For example, 20.1.x should be able to upgrade from any interim build created after the 19.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 & current releases, and predictions for upcoming releases:

LabKey ReleaseCan Upgrade From These Official ReleasesCan Upgrade From These Interim Releases
20.1.x17.3 and later19.2.x and later
19.3.x17.2 and later19.1.x and later
19.2.x17.1 and later18.3.x and later
19.1.x16.3 and later18.2 and later
18.3.x16.2 and later18.1 and later
18.216.1 and later17.3 and later
18.115.3 and later17.2 and later
17.315.2 and later17.1 and later
17.215.1 and later16.3 and later
17.114.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.


Was this content helpful?

Log in or register an account to provide feedback

expand all collapse all