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 LabKey Server 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). Production quality releases of Sample Manager and Biologics are available each month.
  • Maintenance releases. LabKey issues reliability fixes and minor enhancements via periodic maintenance releases. Production releases have maintenance updates scheduled every two weeks, typically for several months after each production release. Maintenance releases include a non-zero minor version, for example, 20.3.1, 20.7.4. Maintenance releases are cumulative; each includes all the fixes and enhancements included in all previous maintenance releases.
  • Monthly releases. Every month we provide a LabKey Server release intended for development, testing, and staging servers, but not for production. 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. Sample Manager and Biologics provide monthly releases that are intended for production use.
  • 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, upgrades can be skipped for a full year (or longer in some cases):

  • Every release can directly upgrade every release from that year and the previous year. For example, 22.2 through 23.1 can upgrade servers running any 21.x or previous 22.x release. That provides an upgrade window of 13 - 24 months. Any earlier release (20.x or before) will not be able to upgrade directly to 22.2 or later.
  • Some earlier releases (e.g., 21.3) support a longer upgrade window; consult the chart below for details.
  • While we discourage running LabKey Server monthly releases or snapshot (nightly) builds in production environments, we support upgrading monthly and snapshot builds under the same rules (beginning with LabKey 19.1.0).

This 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 and upcoming releases:

ReleasesCan Upgrade From These Releases
23.2.0 - and later
22.2.0 - and later
21.11.0 - and later
21.7.x19.1.0 and later
21.3.x19.1.0 and later
20.11.x19.1.0 and later

The table below shows the upgrade scenarios supported by past releases that followed our previous upgrade policy:

Production ReleaseCan Upgrade From These Production ReleasesCan Upgrade From These Monthly Releases and Snapshot Builds
20.7.x18.1 and later19.1.0 and later
20.3.x17.3 and later19.1.0 and later
19.3.x17.2 and later19.1.0 and later
19.2.x17.1 and later18.3.0 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