App Service upgrades the underlying Node.js runtime and SDK of your application as part of the regular platform updates. As a result of this update process, your application will be automatically updated to the latest patch version available in the platform for the configured runtime of your app.
Once a version of Node.js has reached it's end of life (EOL) it will no longer be available from Runtime Stack selection dropdown.
Existing applications configured to target a runtime version that has reached EOL should not be affected.
On April 30th, 2022 Node 12 will no longer be offered as an option in the create process for App Service. Existing apps targeting Node 12 will not be affected. We recommend migrating your application to Node 14 LTS. See our guidance below to target a new version.
| Version | Support Status | End of Support | OS Support |
|---|---|---|---|
| Node 20 LTS | Active LTS | April 30 2027 | Windows & Linux |
| Node 18 LTS | Maintenance | April 30 2025 | Windows & Linux |
| Node 16 LTS | End of Life | September 11 2023 | Windows & Linux |
| Node 14 LTS | End of Life | April 30 2023 | Windows & Linux |
| Node 12 LTS | End of Life | April 30 2022 | Windows & Linux |
| Node 10.x | End of Life | April 30 2021 | Windows & Linux |
| Node 9.x | End of Life | June 30 2019 | Windows & Linux |
| Node 8.x | End of Life | December 31 2019 | Windows & Linux |
NOTE: Changing the stack settings of your app will trigger a re-start of your application.
If you are hosting a node.js app on a Windows webapp, the runtime version of your app is configured through an app setting WEBSITE_NODE_DEFAULT_VERSION.
You can change the value of this app setting through the Azure portal, or through Azure CLI:
az webapp config appsettings set --name <app-name> --resource-group <resource-group-name> --settings WEBSITE_NODE_DEFAULT_VERSION="~16"
Note: This example uses the recommended "tilde syntax" to target the latest available version of Node.js 16 runtime on App Service. Since the runtime is regularly patched and updated by the platform it's not recommended to target a specific minor version/patch as these are not guaranteed to be available due to potential security risks.
If you are hosting a node.js app on a Linux webapp, the runtime version of your app is configured through linux-fx-version property.
You can change the target runtime through Azure CLI:
az webapp config set --resource-group <resource-group-name> --name <app-name> --linux-fx-version "NODE|14-lts"
You can also change the runtime throgh the Azure portal:
- In the Azure portal, click the App Service blade. Select the app you want to update.
- In the Configuration panel, click the General settings tab.
- Under Stack Settings, click the drop-down menu under Major version and select the Node version you want (we recommend choosing the most recent version).
- Click Save.
