---
title: "Atualizando o Amplia da versão 3.x para 4.0"
description: "Como atualizar um Amplia on-premises da versão 3.x para a 4.0, que passa a usar o ASP.NET Core 6.0, com um aviso sobre a criação de índices em bancos de dados grandes."
canonical: "https://docs.lacunasoftware.com/articles/amplia/on-premises/update-40"
locale: "pt-BR"
product: "Amplia"
last_updated: "2026-10-12"
---

# Atualizando o Amplia da versão 3.x para 4.0

> **Observação**
>
> Se a sua instância do Amplia estiver em uma versão 2.x, [atualize primeiro para a 3.0](https://docs.lacunasoftware.com/articles/amplia/on-premises/update-30)

> **Aviso**
>
> Esta atualização cria dois índices que faltavam, nas tabelas `Orders` e `Certificates`. Se o seu banco de dados tiver um número elevado de pedidos e/ou
> certificados (vários milhares ou mais), a atualização do banco de dados pode falhar. Nesse caso, atualize o banco de dados manualmente com o comando
> [update-db](https://docs.lacunasoftware.com/articles/amplia/on-premises/tool/update-db), passando um valor alto em `--timeout <seconds>`.

Como o ASP.NET Core 3.1 foi descontinuado, a versão [4.0](https://docs.lacunasoftware.com/articles/amplia/changelog#v4-0-0) do [Amplia](https://docs.lacunasoftware.com/articles/amplia) foi migrada para o ASP.NET Core 6.0, que é
a versão LTS mais recente do ASP.NET Core, [com suporte da Microsoft até novembro de 2024](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 6.0.

Consulte a seção de instalação do ASP.NET Core Runtime 6.0 do procedimento de instalação correspondente à sua plataforma:

* [Windows Server](https://docs.lacunasoftware.com/articles/amplia/on-premises/windows/install#install-aspnet-core)
* 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)

> **Observação**
>
> No Docker, não há nada a fazer: a nova imagem 4.0 já é baseada na imagem do ASP.NET Core 6.0

## Azure App Services

Se a sua instância do Amplia estiver hospedada no Azure App Services:

1. No portal do Azure, acesse a configuração do seu App Service
1. Clique em **Configuration** e selecione a aba **General settings**
1. Na seção *Stack settings*:
   1. A configuração *Stack* deve estar definida como **.NET**
   1. A configuração *.NET version* deve estar definida como **.NET 6 (LTS)**

> **Dica**
>
> A seção *Stack settings* mencionada acima só é exibida se o App Service Plan for baseado em Windows. Em planos baseados em Linux, nenhuma alteração é necessária.