LabKey provides clients with three types of regular releases, and also creates nightly snapshot builds primarily for internal LabKey use:
  • Production releases. Every four months we provide a release intended for production use. Production releases are tested thoroughly and receive maintenance updates for approximately six months after initial production release. Production releases are versioned using year and month, for example: 20.3.0 (March 2020 production release), 20.7.0 (July 2020 production release), 20.11.0 (November 2020 production release).
  • Maintenance releases. LabKey issues reliability fixes and minor enhancements via periodic maintenance releases. Production releases have maintenance updates scheduled every two - three weeks. Maintenance releases include a non-zero minor version, for example, 20.3.1, 20.7.4.
  • Monthly releases. Every month we provide a release intended for development, testing, and staging servers. Our clients can use monthly releases to preview and test new features that LabKey has developed. Monthly releases are versioned with year and month, for example: 20.1.0, 20.4.0, 20.10.0.
  • Snapshot builds. These builds are produced nightly with whatever has been changed each day. They should not be deployed to production servers. They are intended for internal LabKey testing, or for external developers who are running LabKey Server on their workstations.
We strongly recommend that every production deployment 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 ensures a straightforward 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 a 17.3 (November 2017 release) or later production release should be able to upgrade to 20.3.x; any earlier release (17.2 and before) will not be able to upgrade directly to 20.3.x.
  • We discourage running monthly releases or snapshot (nightly) builds in any production environment. However, beginning with LabKey 19.1.x, we support upgrading monthly and snapshot builds for two years as well. (This is a change in policy, as of February 2020.)
The two-year upgrade policy provides flexibility for LabKey Server users. Having a window of support for 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 that follow our most recent version number scheme and upgrade policy, and predictions for upcoming releases:

Production ReleaseCan Upgrade From These Production ReleasesCan Upgrade From These Monthly Releases and Snapshot Builds
21.7.x19.1.x and later19.1.x and later
21.3.x18.3.x and later19.1.x and later
20.11.x18.2 and later19.1.x and later
20.7.x18.1 and later19.1.x and later
20.3.x17.3 and later19.1.x and later

The table below shows the upgrade scenarios supported for past releases that followed our previous version number scheme and upgrade policy:

Production ReleaseCan Upgrade From These Production ReleasesCan Upgrade From These Monthly Releases and Snapshot Builds
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