Compartilhar via

Instalar .NET SDK ou .NET Runtime no Ubuntu

Este artigo discute como instalar .NET no Ubuntu.

Instale o SDK (que inclui o runtime) se você quiser desenvolver .NET aplicativos. Ou, se você precisar apenas executar aplicativos, instale o runtime. Se você estiver instalando o Runtime, sugerimos que instale o ASP.NET Core Runtime pois ele inclui runtimes .NET e ASP.NET Core.

Use os comandos dotnet --list-sdks e dotnet --list-runtimes para ver quais versões estão instaladas. Para obter mais informações, consulte Como verificar se o .NET já está instalado.

Importante

Usar um gerenciador de pacotes para instalar .NET do feed de pacotes Microsoft dá suporte apenas à arquitetura x64. Outras arquiteturas, como o Arm64, não são compatíveis com o feed de pacotes da Microsoft. Use os feeds do Ubuntu ou instale manualmente .NET. Tenha cuidado com problemas de confusão de pacotes ao usar vários feeds. Para obter mais informações, consulte .NET combinações de pacotes no Linux.

Para obter mais informações sobre como instalar .NET sem um gerenciador de pacotes, consulte um dos seguintes artigos:

Ubuntu 25.10

.NET está disponível nos feeds do gerenciador de pacotes do Ubuntu. O repositório de pacotes da Microsoft não contém mais pacotes .NET para o Ubuntu.

As seguintes versões de .NET têm suporte ou estão disponíveis para o Ubuntu 25.10:

Versões de .NET com suporte Disponível em
feed interno do Ubuntu		 Disponível em
retroportações
Feed do Ubuntu		 Disponível em
Feed da Microsoft
10.0, 9.0, 8.0 10.0, 9.0, 8.0 Nenhum Nenhum

Quando uma versão Ubuntu fica sem suporte, .NET não tem mais suporte com essa versão.

Instalar o SDK

O SDK do .NET permite que você desenvolva aplicativos com .NET. Se você instalar o SDK do .NET, não precisará instalar o runtime correspondente. Para instalar o SDK do .NET, execute os seguintes comandos:

sudo apt-get update && \
  sudo apt-get install -y dotnet-sdk-10.0

Para saber como usar a CLI .NET, consulte .NET visão geral da CLI.

Instalar o runtime

O ASP.NET Core Runtime permite que você execute aplicativos que foram feitos com .NET que não forneceram o runtime. Os comandos a seguir instalam o ASP.NET Core Runtime, que é o runtime mais compatível para .NET. Em seu terminal, execute os seguintes comandos:

sudo apt-get update && \
  sudo apt-get install -y aspnetcore-runtime-10.0

Como alternativa ao ASP.NET Core Runtime, você pode instalar o .NET Runtime, que não inclui ASP.NET Core suporte: substitua aspnetcore-runtime-10.0 no comando anterior por dotnet-runtime-10.0:

sudo apt-get install -y dotnet-runtime-10.0

Para saber como usar a CLI .NET, consulte .NET visão geral da CLI.

Dependências

Quando você faz a instalação com um gerenciador de pacotes, essas bibliotecas são instaladas automaticamente. Porém, se você instalar manualmente o .NET ou publicar um aplicativo autossuficiente, precisará garantir que essas bibliotecas estejam instaladas:

  • certificados CA
  • libc6
  • libgcc-s1
  • libgssapi-krb5-2
  • libicu76
  • libssl3t64
  • libstdc++6
  • tzdata
  • zlib1g

As dependências podem ser instaladas usando o comando apt install. O snippet a seguir demonstra a instalação da biblioteca zlib1g:

sudo apt install zlib1g

Ubuntu 25.04

.NET está disponível nos feeds do gerenciador de pacotes do Ubuntu. O repositório de pacotes da Microsoft não contém mais pacotes .NET para o Ubuntu.

As seguintes versões de .NET têm suporte ou estão disponíveis para o Ubuntu 25.04:

Versões de .NET com suporte Disponível em
feed interno do Ubuntu		 Disponível em
retroportações
Feed do Ubuntu		 Disponível em
Feed da Microsoft
10.0, 9.0, 8.0 10.0, 9.0, 8.0 Nenhum Nenhum

Quando uma versão Ubuntu fica sem suporte, .NET não tem mais suporte com essa versão.

Instalar o SDK

O SDK do .NET permite que você desenvolva aplicativos com .NET. Se você instalar o SDK do .NET, não precisará instalar o runtime correspondente. Para instalar o SDK do .NET, execute os seguintes comandos:

sudo apt-get update && \
  sudo apt-get install -y dotnet-sdk-10.0

Para saber como usar a CLI .NET, consulte .NET visão geral da CLI.

Instalar o runtime

O ASP.NET Core Runtime permite que você execute aplicativos que foram feitos com .NET que não forneceram o runtime. Os comandos a seguir instalam o ASP.NET Core Runtime, que é o runtime mais compatível para .NET. Em seu terminal, execute os seguintes comandos:

sudo apt-get update && \
  sudo apt-get install -y aspnetcore-runtime-10.0

Como alternativa ao ASP.NET Core Runtime, você pode instalar o .NET Runtime, que não inclui ASP.NET Core suporte: substitua aspnetcore-runtime-10.0 no comando anterior por dotnet-runtime-10.0:

sudo apt-get install -y dotnet-runtime-10.0

Para saber como usar a CLI .NET, consulte .NET visão geral da CLI.

Dependências

Quando você faz a instalação com um gerenciador de pacotes, essas bibliotecas são instaladas automaticamente. Porém, se você instalar manualmente o .NET ou publicar um aplicativo autossuficiente, precisará garantir que essas bibliotecas estejam instaladas:

  • certificados CA
  • libc6
  • libgcc-s1
  • libgssapi-krb5-2
  • libicu76
  • libssl3t64
  • libstdc++6
  • tzdata
  • zlib1g

As dependências podem ser instaladas usando o comando apt install. O snippet a seguir demonstra a instalação da biblioteca zlib1g:

sudo apt install zlib1g

Ubuntu 24.04

.NET está disponível nos feeds do gerenciador de pacotes do Ubuntu. O repositório de pacotes da Microsoft não contém mais pacotes .NET para o Ubuntu.

As seguintes versões de .NET têm suporte ou estão disponíveis para o Ubuntu 24.04:

Versões de .NET com suporte Disponível em
feed interno do Ubuntu		 Disponível em
retroportações
Feed do Ubuntu		 Disponível em
Feed da Microsoft
10.0, 9.0, 8.0 10.0, 8.0 9.0, 7.0, 6.0 Nenhum

Quando uma versão Ubuntu fica sem suporte, .NET não tem mais suporte com essa versão.

Instalar o SDK

O SDK do .NET permite que você desenvolva aplicativos com .NET. Se você instalar o SDK do .NET, não precisará instalar o runtime correspondente. Para instalar o SDK do .NET, execute os seguintes comandos:

sudo apt-get update && \
  sudo apt-get install -y dotnet-sdk-10.0

Para saber como usar a CLI .NET, consulte .NET visão geral da CLI.

Instalar o runtime

O ASP.NET Core Runtime permite que você execute aplicativos que foram feitos com .NET que não forneceram o runtime. Os comandos a seguir instalam o ASP.NET Core Runtime, que é o runtime mais compatível para .NET. Em seu terminal, execute os seguintes comandos:

sudo apt-get update && \
  sudo apt-get install -y aspnetcore-runtime-10.0

Como alternativa ao ASP.NET Core Runtime, você pode instalar o .NET Runtime, que não inclui ASP.NET Core suporte: substitua aspnetcore-runtime-10.0 no comando anterior por dotnet-runtime-10.0:

sudo apt-get install -y dotnet-runtime-10.0

Para saber como usar a CLI .NET, consulte .NET visão geral da CLI.

Dependências

Quando você faz a instalação com um gerenciador de pacotes, essas bibliotecas são instaladas automaticamente. Porém, se você instalar manualmente o .NET ou publicar um aplicativo autossuficiente, precisará garantir que essas bibliotecas estejam instaladas:

  • certificados CA
  • libc6
  • libgcc-s1
  • libgssapi-krb5-2
  • libicu74
  • libssl3t64
  • libstdc++6
  • tzdata
  • zlib1g

As dependências podem ser instaladas usando o comando apt install. O snippet a seguir demonstra a instalação da biblioteca zlib1g:

sudo apt install zlib1g

Ubuntu 22.04

.NET está disponível nos feeds do gerenciador de pacotes do Ubuntu, bem como no repositório de pacotes da Microsoft. No entanto, você deve usar apenas um ou outro para instalar .NET. A Microsoft recomenda que você use os feeds do gerenciador de pacotes do Ubuntu. Para usar o repositório de pacotes da Microsoft, confira Como registrar o repositório de pacotes da Microsoft.

As seguintes versões de .NET têm suporte ou estão disponíveis para o Ubuntu 22.04:

Versões de .NET com suporte Disponível em
feed interno do Ubuntu		 Disponível em
.NET retroportações
Feed do Ubuntu		 Disponível em
Feed da Microsoft
10.0, 9.0, 8.0 8.0, 7.0, 6.0 10.0, 9.0 8.0, 7.0, 6.0, 3.1

Importante

Se você estiver usando .NET SDK 8 e Ubuntu 22.04, entenda que as versões do SDK oferecidas pela Canonical estão sempre na faixa de recursos .1xx. Se você quiser usar uma versão mais recente da banda de versão, use o feed da Microsoft para instalar o SDK. Certifique-se de revisar as informações no artigo .NET mistura de pacotes no Linux para entender as implicações de alternar entre fontes de repositório.

Quando uma versão Ubuntu fica sem suporte, .NET não tem mais suporte com essa versão.

.NET está disponível no repositório de pacotes de backports do Ubuntu .NET. Para adicionar o repositório, abra um terminal e execute o seguinte comando:

sudo add-apt-repository ppa:dotnet/backports

Instalar o SDK

O SDK do .NET permite que você desenvolva aplicativos com .NET. Se você instalar o SDK do .NET, não precisará instalar o runtime correspondente. Para instalar o SDK do .NET, execute os seguintes comandos:

sudo apt-get update && \
  sudo apt-get install -y dotnet-sdk-10.0

Para saber como usar a CLI .NET, consulte .NET visão geral da CLI.

Instalar o runtime

O ASP.NET Core Runtime permite que você execute aplicativos que foram feitos com .NET que não forneceram o runtime. Os comandos a seguir instalam o ASP.NET Core Runtime, que é o runtime mais compatível para .NET. Em seu terminal, execute os seguintes comandos:

sudo apt-get update && \
  sudo apt-get install -y aspnetcore-runtime-10.0

Como alternativa ao ASP.NET Core Runtime, você pode instalar o .NET Runtime, que não inclui ASP.NET Core suporte: substitua aspnetcore-runtime-10.0 no comando anterior por dotnet-runtime-10.0:

sudo apt-get install -y dotnet-runtime-10.0

Para saber como usar a CLI .NET, consulte .NET visão geral da CLI.

Dependências

Quando você faz a instalação com um gerenciador de pacotes, essas bibliotecas são instaladas automaticamente. Porém, se você instalar manualmente o .NET ou publicar um aplicativo autossuficiente, precisará garantir que essas bibliotecas estejam instaladas:

  • certificados CA
  • libc6
  • libgcc-s1
  • libgssapi-krb5-2
  • libicu70
  • libssl3
  • libstdc++6
  • tzdata
  • zlib1g

As dependências podem ser instaladas usando o comando apt install. O snippet a seguir demonstra a instalação da biblioteca zlib1g:

sudo apt install zlib1g

Versões sem suporte

As seguintes versões de .NET ❌ não têm mais suporte:

  • .NET 7
  • .NET 6
  • .NET 5
  • .NET Core 3.1
  • .NET Core 3.0
  • .NET Core 2.2
  • .NET Core 2.1
  • .NET Core 2.0

Como instalar outras versões

Os nomes de pacote do .NET são padronizados em todas as distribuições Linux. A seguinte tabela lista os pacotes:

Todas as versões de .NET estão disponíveis para download em https://dotnet.microsoft.com/download/dotnet, mas exigem instalação manual. Você pode tentar usar o gerenciador de pacotes para instalar uma versão diferente do .NET. No entanto, a versão solicitada pode não estar disponível.

Os pacotes adicionados aos feeds do gerenciador de pacotes são nomeados em um formato hackeável, por exemplo: {product}-{type}-{version}.

  • produto
    O tipo de .NET produto a ser instalado. As opções válidas são:

    • dotnet
    • aspnetcore

  • type
    Escolhe o SDK ou o runtime. As opções válidas são:

    • sdk(disponível apenas para o produto dotnet)
    • runtime

  • versão
    A versão do SDK ou do runtime a ser instalada. As opções válidas são qualquer versão lançada, como:

    • 9.0
    • 8.0
    • 3.1
    • 2.1

    É possível que o SDK/runtime que você está tentando baixar não esteja disponível para sua distribuição Linux. Para obter uma lista de distribuições com suporte, consulte Instalar .NET no Linux.

Exemplos

  • Instale o runtime do ASP.NET Core 9.0: aspnetcore-runtime-9.0
  • Instalar o runtime do .NET Core 2.1: dotnet-runtime-2.1
  • Instalar o SDK do .NET 5: dotnet-sdk-5.0
  • Instale o SDK do .NET Core 3.1: dotnet-sdk-3.1

Observação

Alguns pacotes podem não estar disponíveis em sua distribuição Linux.

Ausência de pacote

Se a combinação pacote-versão não funcionar, ela não estará disponível. Por exemplo, não há um SDK ASP.NET Core. Os componentes do SDK para ASP.NET Core são incluídos no SDK do .NET. O valor aspnetcore-sdk-8.0 está incorreto e deve ser dotnet-sdk-8.0. Para obter uma lista de distribuições do Linux compatíveis com .NET, consulte .NET dependências e requisitos.

Próximas etapas

  • Last updated on