--- title: "Atualizando o Amplia da versão 4.x para 5.0" description: "Como atualizar um Amplia on-premises da versão 4.x para a 5.0, que passa a usar o ASP.NET Core 10.0 e atualiza o modelo do banco de dados, com notas sobre Prometheus e Azure Key Vault." canonical: "https://docs.lacunasoftware.com/articles/amplia/on-premises/update-50" locale: "pt-BR" product: "Amplia" last_updated: "2026-10-12" --- # Atualizando o Amplia da versão 4.x para 5.0 A versão [5.0](https://docs.lacunasoftware.com/articles/amplia/changelog#v5-0-0) do [Amplia](https://docs.lacunasoftware.com/articles/amplia) foi migrada para o ASP.NET Core 10.0, a versão LTS mais recente do ASP.NET Core, [com suporte da Microsoft até novembro de 2028](https://dotnet.microsoft.com/platform/support/policy/dotnet-core#lifecycle). Por isso, para atualizar a sua instância [on-premises](https://docs.lacunasoftware.com/articles/amplia/on-premises), você precisa instalar o ASP.NET Core Runtime 10.0 antes de instalar a nova versão. Consulte a seção de instalação do ASP.NET Core Runtime 10.0 do procedimento de instalação correspondente à sua plataforma: * [Windows Server](https://docs.lacunasoftware.com/articles/amplia/on-premises/windows/install#install-aspnet-core) (ASP.NET Core 10.0 Hosting Bundle) * Linux * [Ubuntu Server](https://docs.lacunasoftware.com/articles/amplia/on-premises/linux/install-ubuntu#install-aspnet-core) * [Red Hat Enterprise Linux](https://docs.lacunasoftware.com/articles/amplia/on-premises/linux/install-rhel#install-aspnet-core) * [Oracle Linux](https://docs.lacunasoftware.com/articles/amplia/on-premises/linux/install-oracle#install-aspnet-core) * [Rocky Linux](https://docs.lacunasoftware.com/articles/amplia/on-premises/linux/install-rocky#instale-o-aspnet-core-runtime-100) > **Observação** > > O .NET 10 não oferece mais suporte a algumas versões antigas de sistemas operacionais, como Red Hat Enterprise Linux 7 e Oracle Linux 7. Se o seu servidor > usa uma delas, migre a instância para uma [versão suportada](https://docs.lacunasoftware.com/articles/amplia/on-premises/linux) antes de atualizar. > **Observação** > > No Docker, não há nada a fazer: a imagem 5.0 já é baseada na imagem do ASP.NET Core 10.0. Use a imagem `lacunasoftware/amplia:5.0` > (veja [Setup do Amplia em Docker](https://docs.lacunasoftware.com/articles/amplia/on-premises/docker)). Em seguida, atualize o Amplia normalmente: * [Atualização do Amplia em Windows Server](https://docs.lacunasoftware.com/articles/amplia/on-premises/windows/update) * [Atualização do Amplia em Linux](https://docs.lacunasoftware.com/articles/amplia/on-premises/linux/update) * [Atualização do Amplia em Azure App Services](https://docs.lacunasoftware.com/articles/amplia/on-premises/azure/update) ## Atualização do modelo do banco de dados Esta atualização altera o modelo do banco de dados. Por padrão, o Amplia atualiza o modelo do banco de dados sozinho ao iniciar. Se o Amplia opera sem ser *owner* do banco de dados, atualize o modelo do banco de dados com o comando [update-db](https://docs.lacunasoftware.com/articles/amplia/on-premises/tool/update-db) antes de iniciar a nova versão (veja [Operando o Amplia sem ser *owner* do banco de dados](https://docs.lacunasoftware.com/articles/amplia/on-premises/unprivileged-db-user)). ## Métricas do Prometheus O Amplia 5.0 não expõe mais métricas para o Prometheus (a integração experimental adicionada na [4.13.0](https://docs.lacunasoftware.com/articles/amplia/changelog#v4-13-0)). Se você coleta essas métricas, remova o Amplia da configuração do seu Prometheus. ## Key stores Azure Key Vault O [key store Azure Key Vault](https://docs.lacunasoftware.com/articles/amplia/on-premises/key-stores/azure) agora usa a versão 4 do Azure SDK. As configurações existentes (**AppId** com **AppKey** ou **CertThumb**) continuam funcionando. O Amplia 5.0 também adiciona a configuração **UseManagedIdentity**, para autenticar com a identidade gerenciada do host em vez de uma chave secreta ou certificado do aplicativo. ## Azure App Services Se a sua instância do Amplia está hospedada no Azure App Services como descrito em [Instalação do Amplia em Azure App Services](https://docs.lacunasoftware.com/articles/amplia/on-premises/azure/install) (App Service Plan Linux executando a imagem Docker), nenhuma alteração nas configurações de *stack* é necessária: [importe a imagem 5.0](https://docs.lacunasoftware.com/articles/amplia/on-premises/azure/update) e selecione a tag dela. Se a sua instância usa um App Service Plan baseado em Windows, na seção *Stack settings* de **Configuration** > **General settings**, defina a configuração *Stack* como **.NET** e a configuração *.NET version* como .NET 10. ## Veja também * [Histórico de versões do Amplia](https://docs.lacunasoftware.com/articles/amplia/changelog) * [Verificando a versão instalada do Amplia](https://docs.lacunasoftware.com/articles/amplia/on-premises/check-version) * [Atualizando o Amplia da versão 3.x para 4.0](https://docs.lacunasoftware.com/articles/amplia/on-premises/update-40)