---
title: "Update Amplia from 2.16 to 3.0"
description: "Update an on-premises Amplia from 2.16 to 3.0, including setting the ASPNETCORE_ENVIRONMENT variable to Windows, Linux or Azure."
canonical: "https://docs.lacunasoftware.com/en-us/articles/amplia/on-premises/update-30"
locale: "en"
product: "Amplia"
last_updated: "2026-07-14"
---

# Update Amplia from 2.16 to 3.0

To update your [on-premises](https://docs.lacunasoftware.com/en-us/articles/amplia/on-premises) instance of [Amplia](https://docs.lacunasoftware.com/en-us/articles/amplia) from version 2.16.x to [version 3.0](https://docs.lacunasoftware.com/en-us/articles/amplia/changelog#v3-0-0), a few
changes are required.

## ASP.NET Core Environment

Starting on version 3.0, Amplia needs the `ASPNETCORE_ENVIRONMENT` environment variable to be set to either `Windows`, `Linux` or `Azure`.

On Windows Server, run the following command on a privileged command prompt:

```sh
%SYSTEMROOT%\System32\inetsrv\appcmd.exe set config Amplia -section:system.webServer/aspNetCore /+"environmentVariables.[name='ASPNETCORE_ENVIRONMENT',value='Windows']" /commit:apphost
```

On Azure App Services, go to the **Configuration** tab of the app service add an application setting with name `ASPNETCORE_ENVIRONMENT` and value `Azure`.

> **Note**
>
> On Linux, this variable was already set as part of the installation instructions for versions 2.x, so there's nothing to be done

## Configuration changes

* Section `Oidc`
  * `DashboardClientId` → `ClientAppId`
  * Fill new settings `ApiEndpoint`, `AppId` and `AppSecret` accordingly (check with technical support for the correct values)
  * Edit the client app configuration on GrantID, changing allowed redirect URLs from `https://your-amplia-domain/dashboard` to only `https://your-amplia-domain` i.e. removing the suffix `/dashboard` (leave the return URL to *silent-refresh.html*, it is still required)
* On section `PkiSuite`, if you have any `Mobile*` settings (for instance `MobileAppName`), create a section called `MobileApp` and move
  these settings over to that section, renaming them accordingly:
  * `PkiSuite:MobileAppName` → `MobileApp:Name`
  * `PkiSuite:MobileAppCodeSuffix` → `MobileApp:CodeSuffix`
  * `PkiSuite:MobileIOSStoreUri` → `MobileApp:IOSStoreUri`
  * `PkiSuite:MobileAndroidStoreUri` → `MobileApp:AndroidStoreUri`

On Azure App Services:

* If you use a log sink of type *AzureTableStorageWithProperties*, change its `keyGenerator` to `Lacuna.Spa.Engine.AzureTableKeyGenerator, Lacuna.Spa.Engine`
* If you have a section named `AzureStorage`, rename it to `BlobStorage`