These topics provide step by step instructions for upgrading an existing LabKey Server installation to a newer version.

Upgrade on Linux or OSX

• You can upgrade LabKey Server manually.
• OR
• Use the manual-upgrade.sh script to streamline the upgrade process. See Upgrade Script for Linux and OSX for more information.

Upgrade on Windows

• You can upgrade LabKey Server manually.
• OR
• Use the upgrade batch script described here.
• After upgrade, you may need to reset your browser cache. See Troubleshooting Upgrade.

Supported Versions for Upgrade

Please see the LabKey Releases and Upgrade Support Policy page.

Pipeline Jobs

It is a known issue that pipeline jobs that are in progress prior to an upgrade may not resume successfully after an upgrade. The same is true for jobs that may have hit an error condition if they are retried after an upgrade. In general, hotfix releases should not have incompatibilities when resuming jobs, but major version transitions will sometimes exhibit this problem. When possible, it is recommended to let jobs complete prior to performing an upgrade.

To check the status of jobs, use the Pipeline link from the Admin Console.