docs/Reference/LTS.md
<a id="lts"></a>
Fastify's Long Term Support (LTS) is provided according to the schedule laid out in this document:
A "month" is defined as 30 consecutive days.
Security Releases and Semver
As a consequence of providing long-term support for major releases, there are occasions where we need to release breaking changes as a minor version release. Such changes will always be noted in the release notes.
To avoid automatically receiving breaking security updates it is possible to use the tilde (
~) range qualifier. For example, to get patches for the 3.15 release, and avoid automatically updating to the 3.16 release, specify the dependency as"fastify": "~3.15.x". This will leave your application vulnerable, so please use it with caution.
Fastify's partner, HeroDevs, provides commercial security support through the OpenJS Ecosystem Sustainability Program for versions of Fastify that are EOL. For more information, see their Never Ending Support service.
<a id="lts-schedule"></a>
| Version | Release Date | End Of LTS Date | Node.js | Nsolid(Node) |
|---|---|---|---|---|
| 1.0.0 | 2018-03-06 | 2019-09-01 | 6, 8, 9, 10, 11 | |
| 2.0.0 | 2019-02-25 | 2021-01-31 | 6, 8, 10, 12, 14 | |
| 3.0.0 | 2020-07-07 | 2023-06-30 | 10, 12, 14, 16, 18 | v5(18) |
| 4.0.0 | 2022-06-08 | 2025-06-30 | 14, 16, 18, 20, 22 | v5(18), v5(20) |
| 5.0.0 | 2024-09-17 | TBD | 20, 22 | v5(20) |
<a id="supported-os"></a>
Fastify uses GitHub Actions for CI testing, please refer to GitHub's documentation regarding workflow runners for further details on what the latest virtual environment is in relation to the YAML workflow labels below:
| OS | YAML Workflow Label | Package Manager | Node.js | Nsolid(Node) |
|---|---|---|---|---|
| Linux | ubuntu-latest | npm | 20 | v5(20) |
| Linux | ubuntu-latest | yarn,pnpm | 20 | v5(20) |
| Windows | windows-latest | npm | 20 | v5(20) |
| MacOS | macos-latest | npm | 20 | v5(20) |
Using yarn might require passing the --ignore-engines
flag.