---
title: "Update Amplia from 4.x to 5.0"
description: "Update an on-premises Amplia from 4.x to 5.0, which moves to ASP.NET Core 10.0 and updates the database model, with notes on Prometheus and Azure Key Vault."
canonical: "https://docs.lacunasoftware.com/en-us/articles/amplia/on-premises/update-50"
locale: "en"
product: "Amplia"
last_updated: "2026-10-12"
---

# Update Amplia from 4.x to 5.0

Version [5.0](https://docs.lacunasoftware.com/en-us/articles/amplia/changelog#v5-0-0) of [Amplia](https://docs.lacunasoftware.com/en-us/articles/amplia) has been migrated to ASP.NET Core 10.0, the newest LTS release of ASP.NET Core,
[supported by Microsoft until November 2028](https://dotnet.microsoft.com/platform/support/policy/dotnet-core#lifecycle).

Because of that, to update your [on-premises](https://docs.lacunasoftware.com/en-us/articles/amplia/on-premises) instance, you must install the ASP.NET Core Runtime 10.0 before installing the new version.

Please refer to the *Install the ASP.NET Core Runtime 10.0* section of the installation procedure corresponding to your platform:

* [Windows Server](https://docs.lacunasoftware.com/en-us/articles/amplia/on-premises/windows/install#install-aspnet-core) (ASP.NET Core 10.0 Hosting Bundle)
* Linux
  * [Ubuntu Server](https://docs.lacunasoftware.com/en-us/articles/amplia/on-premises/linux/install-ubuntu#install-aspnet-core)
  * [Red Hat Enterprise Linux](https://docs.lacunasoftware.com/en-us/articles/amplia/on-premises/linux/install-rhel#install-aspnet-core)
  * [Oracle Linux](https://docs.lacunasoftware.com/en-us/articles/amplia/on-premises/linux/install-oracle#install-aspnet-core)
  * [Rocky Linux](https://docs.lacunasoftware.com/en-us/articles/amplia/on-premises/linux/install-rocky#install-aspnet-core)

> **Note**
>
> .NET 10 no longer supports some older operating system versions, such as Red Hat Enterprise Linux 7 and Oracle Linux 7. If your server runs one of them, move
> the instance to a [supported version](https://docs.lacunasoftware.com/en-us/articles/amplia/on-premises/linux) before updating.

> **Note**
>
> On Docker, there's nothing to do: the 5.0 image is already based on the ASP.NET Core 10.0 image. Use the `lacunasoftware/amplia:5.0` image
> (see [Setup on Docker](https://docs.lacunasoftware.com/en-us/articles/amplia/on-premises/docker)).

Then update Amplia as usual:

* [Updating Amplia on Windows Server](https://docs.lacunasoftware.com/en-us/articles/amplia/on-premises/windows/update)
* [Updating Amplia on Linux](https://docs.lacunasoftware.com/en-us/articles/amplia/on-premises/linux/update)
* [Updating Amplia on Azure App Services](https://docs.lacunasoftware.com/en-us/articles/amplia/on-premises/azure/update)

## Database model update

This update changes the database model. By default, Amplia updates the database model by itself when it starts. If Amplia runs without owner privileges over the
database, update the database model with the [update-db](https://docs.lacunasoftware.com/en-us/articles/amplia/on-premises/tool/update-db) command before starting the new version (see
[Running Amplia without db_owner privileges](https://docs.lacunasoftware.com/en-us/articles/amplia/on-premises/unprivileged-db-user)).

## Prometheus metrics

Amplia 5.0 no longer exposes metrics for Prometheus (the experimental integration added in [4.13.0](https://docs.lacunasoftware.com/en-us/articles/amplia/changelog#4-13-0)). If you collect these metrics,
remove Amplia from your Prometheus configuration.

## Azure Key Vault key stores

The [Azure Key Vault key store](https://docs.lacunasoftware.com/en-us/articles/amplia/on-premises/key-stores/azure) now uses version 4 of the Azure SDK. Existing settings (**AppId** with **AppKey** or **CertThumb**) keep working.
Amplia 5.0 also adds the **UseManagedIdentity** setting, to authenticate with the managed identity of the host instead of an application secret or certificate.

## Azure App Services

If your Amplia instance is hosted on Azure App Services as described on [Installing Amplia on Azure App Services](https://docs.lacunasoftware.com/en-us/articles/amplia/on-premises/azure/install) (Linux App Service Plan
running the Docker image), no change to the stack settings is needed: [import the 5.0 image](https://docs.lacunasoftware.com/en-us/articles/amplia/on-premises/azure/update) and select its tag.

If your instance runs on a Windows-based App Service Plan, on the *Stack settings* section of **Configuration** > **General settings**, set the *Stack* setting to
**.NET** and the *.NET version* setting to .NET 10.

## See also

* [Amplia changelog](https://docs.lacunasoftware.com/en-us/articles/amplia/changelog)
* [Checking the version of Amplia](https://docs.lacunasoftware.com/en-us/articles/amplia/on-premises/check-version)
* [Update Amplia from 3.x to 4.0](https://docs.lacunasoftware.com/en-us/articles/amplia/on-premises/update-40)