Instalar o .NET SDK ou .NET Runtime no Ubuntu

  • Artigo

Este artigo descreve como instalar o .NET no Ubuntu.

Instale o SDK (que inclui o tempo de execução) se quiser desenvolver aplicativos .NET. Ou, se você só precisar executar aplicativos, instale o Runtime. Se você estiver instalando o Runtime, sugerimos que instale o ASP.NET Core Runtime , pois ele inclui os tempos de execução .NET e ASP.NET Core.

Use os dotnet --list-sdks comandos 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 o .NET a partir do feed de pacotes da Microsoft suporta apenas a arquitetura x64. Outras arquiteturas, como Arm, não são suportadas pelo feed de pacotes da Microsoft. Use os feeds do Ubuntu ou instale manualmente o .NET. Tenha cuidado com problemas de mistura de embalagens ao usar vários feeds. Para obter mais informações, consulte Misturas de pacotes .NET no Linux.

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

Ubuntu 24,10

O .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 do .NET são suportadas ou estão disponíveis para o Ubuntu 24.10:

  • 9.0
  • 8.0

Importante

O .NET 9 está atualmente em visualização.

Quando uma versão do Ubuntu deixa de ser suportada, o .NET não é mais suportado com essa versão.

Instale o SDK

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

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

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

Instalar o tempo de execução

O ASP.NET Core Runtime permite executar aplicativos que foram criados com .NET que não forneceram o tempo de execução. Os comandos a seguir instalam o ASP.NET Core Runtime, que é o tempo de execução mais compatível para o .NET. No seu terminal, execute os seguintes comandos:

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

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

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

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

Dependências

Quando você instala com um gerenciador de pacotes, essas bibliotecas são instaladas para você. Mas, se você instalar manualmente o .NET ou publicar um aplicativo independente, precisará garantir que essas bibliotecas estejam instaladas:

  • Certificados CA
  • libc6
  • libgcc-s1
  • Libicu74
  • liblttng-ust1
  • libssl3
  • libstdc++6
  • libunwind8
  • Zlib1g

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

sudo apt install zlib1g

Se o aplicativo .NET usa o assembly System.Drawing.Common , o libgdiplus também precisará ser instalado. Como System.Drawing.Common não é mais suportado no Linux, isso só funciona no .NET 6 e requer a configuração da opção de configuração de System.Drawing.EnableUnixSupport tempo de execução.

Você pode instalar uma versão recente do libgdiplus adicionando o repositório Mono ao seu sistema.

Ubuntu 24.04

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

As seguintes versões do .NET são suportadas ou estão disponíveis para o Ubuntu 24.04:

Versões .NET suportadas Available in
built-in Ubuntu feed		 Disponível em
backports
Feed do Ubuntu		 Disponível em
Feed da Microsoft
8.0, 6.0 8.0 7.0, 6.0 Nenhuma

Quando uma versão do Ubuntu deixa de ser suportada, o .NET não é mais suportado com essa versão.

Não disponível.

Dependências

Quando você instala com um gerenciador de pacotes, essas bibliotecas são instaladas para você. Mas, se você instalar manualmente o .NET ou publicar um aplicativo independente, precisará garantir que essas bibliotecas estejam instaladas:

  • Certificados CA
  • libc6
  • libgcc-s1
  • Libicu74
  • liblttng-ust1
  • libssl3
  • libstdc++6
  • libunwind8
  • Zlib1g

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

sudo apt install zlib1g

Se o aplicativo .NET usa o assembly System.Drawing.Common , o libgdiplus também precisará ser instalado. Como System.Drawing.Common não é mais suportado no Linux, isso só funciona no .NET 6 e requer a configuração da opção de configuração de System.Drawing.EnableUnixSupport tempo de execução.

Você pode instalar uma versão recente do libgdiplus adicionando o repositório Mono ao seu sistema.

Ubuntu 22.04

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

As seguintes versões do .NET são suportadas ou estão disponíveis para o Ubuntu 22.04:

Versões .NET suportadas Available in
built-in Ubuntu feed		 Disponível em
Backports .NET
Feed do Ubuntu		 Disponível em
Feed da Microsoft
8.0, 6.0 8.0, 7.0, 6.0 Nenhuma 8.0, 7.0, 6.0, 3.1

Importante

Se você estiver usando o SDK do .NET 8 e o 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 recursos, use o feed da Microsoft para instalar o SDK. Certifique-se de revisar as informações no artigo Misturas de pacotes .NET no Linux para entender as implicações da alternância entre feeds de repositório.

Quando uma versão do Ubuntu deixa de ser suportada, o .NET não é mais suportado com essa versão.

Não disponível.

Dependências

Quando você instala com um gerenciador de pacotes, essas bibliotecas são instaladas para você. Mas, se você instalar manualmente o .NET ou publicar um aplicativo independente, precisará garantir que essas bibliotecas estejam instaladas:

  • Certificados CA
  • libc6
  • libgcc-s1
  • libgssapi-krb5-2
  • Libicu70
  • liblttng-ust1
  • libssl3
  • libstdc++6
  • libunwind8
  • Zlib1g

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

sudo apt install zlib1g

Se o aplicativo .NET usa o assembly System.Drawing.Common , o libgdiplus também precisará ser instalado. Como System.Drawing.Common não é mais suportado no Linux, isso só funciona no .NET 6 e requer a configuração da opção de configuração de System.Drawing.EnableUnixSupport tempo de execução.

Você pode instalar uma versão recente do libgdiplus adicionando o repositório Mono ao seu sistema.

Ubuntu 20.04

O repositório de pacotes padrão do Ubuntu não contém esta versão do .NET. Em vez disso, use o repositório de pacotes da Microsoft.

As seguintes versões do .NET são suportadas ou estão disponíveis para o Ubuntu 20.04:

Versões .NET suportadas Available in
built-in Ubuntu feed		 Disponível em
Backports .NET
Feed do Ubuntu		 Disponível em
Feed da Microsoft
8.0, 6.0 Nenhuma Nenhuma 8.0, 7.0. 6.0, 5.0, 3.1, 2.1

Quando uma versão do Ubuntu deixa de ser suportada, o .NET não é mais suportado com essa versão.

Adicionar o repositório de pacotes da Microsoft

A instalação com APT pode ser feita com alguns comandos. Antes de instalar o .NET, execute os seguintes comandos para adicionar a chave de assinatura do pacote Microsoft à sua lista de chaves confiáveis e adicionar o repositório de pacotes.

Abra um terminal e execute os seguintes comandos:

wget https://packages.microsoft.com/config/ubuntu/20.04/packages-microsoft-prod.deb -O packages-microsoft-prod.deb
sudo dpkg -i packages-microsoft-prod.deb
rm packages-microsoft-prod.deb

Não disponível.

Dependências

Quando você instala com um gerenciador de pacotes, essas bibliotecas são instaladas para você. Mas, se você instalar manualmente o .NET ou publicar um aplicativo independente, precisará garantir que essas bibliotecas estejam instaladas:

  • Certificados CA
  • libc6
  • libgcc-s1
  • libgssapi-krb5-2
  • Libicu66
  • libssl1,1
  • libstdc++6
  • Zlib1g

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

sudo apt install zlib1g

Se o aplicativo .NET usa o assembly System.Drawing.Common , o libgdiplus também precisará ser instalado. Como System.Drawing.Common não é mais suportado no Linux, isso só funciona no .NET 6 e requer a configuração da opção de configuração de System.Drawing.EnableUnixSupport tempo de execução.

Você pode instalar uma versão recente do libgdiplus adicionando o repositório Mono ao seu sistema.

Versões não suportadas

As seguintes versões do .NET não são ❌ mais suportadas:

  • .NET 7
  • .NET 6 (a partir de 12 de novembro de 2024)
  • .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 pacotes .NET são padronizados em todas as distribuições Linux. A tabela a seguir lista os pacotes:

Todas as versões do .NET estão disponíveis para download em https://dotnet.microsoft.com/download/dotnet, mas requerem 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 produto .NET a ser instalado. As opções válidas são:

    • dotnet
    • aspnetcore

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

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

  • Versão
    A versão do SDK ou tempo de execução a ser instalado. As opções válidas são qualquer versão lançada, como:

    • 8.0
    • 6.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 suportadas, consulte Instalar o .NET no Linux.

Exemplos

  • Instale o tempo de execução do ASP.NET Core 8.0: aspnetcore-runtime-8.0
  • Instale o tempo de execução do .NET Core 2.1: dotnet-runtime-2.1
  • Instale o SDK do .NET 5: dotnet-sdk-5.0
  • Instale o SDK do .NET Core 3.1: dotnet-sdk-3.1

Nota

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

Pacote em falta

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 estã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 Linux suportadas pelo .NET, consulte Dependências e requisitos do .NET.

Instalação manual

Se a sua versão do Ubuntu não é suportada, você provavelmente precisa instalar o .NET extraindo manualmente os binários, usando o script de instalação. Para obter mais informações, consulte Instalar o .NET no Linux sem usar um gerenciador de pacotes.

Ubuntu 23,10

Aviso

Esta versão do Ubuntu não é mais suportada.

A execução do .NET nesta versão do Ubuntu não é mais suportada.

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

As seguintes versões do .NET foram suportadas ou disponíveis para o Ubuntu 23.10:

Versões .NET suportadas Available in
built-in Ubuntu feed		 Disponível em
Backports .NET
Feed do Ubuntu		 Disponível em
Feed da Microsoft
8.0, 6.0 8.0, 7.0, 6.0 Nenhuma 8.0, 7.0, 6.0

Importante

Se você estiver usando o SDK do .NET 8 e o 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 recursos, use o feed da Microsoft para instalar o SDK. Certifique-se de revisar as informações no artigo Misturas de pacotes .NET no Linux para entender as implicações da alternância entre feeds de repositório.

Quando uma versão do Ubuntu deixa de ser suportada, o .NET não é mais suportado com essa versão.

Não disponível.

Dependências

Quando você instala com um gerenciador de pacotes, essas bibliotecas são instaladas para você. Mas, se você instalar manualmente o .NET ou publicar um aplicativo independente, precisará garantir que essas bibliotecas estejam instaladas:

  • Certificados CA
  • libc6
  • libgcc-s1
  • libgssapi-krb5-2
  • Libicu72
  • liblttng-ust1
  • libssl3
  • libstdc++6
  • libunwind8
  • Zlib1g

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

sudo apt install zlib1g

Se o aplicativo .NET usa o assembly System.Drawing.Common , o libgdiplus também precisará ser instalado. Como System.Drawing.Common não é mais suportado no Linux, isso só funciona no .NET 6 e requer a configuração da opção de configuração de System.Drawing.EnableUnixSupport tempo de execução.

Você pode instalar uma versão recente do libgdiplus adicionando o repositório Mono ao seu sistema.

Ubuntu 23,04

Aviso

Esta versão do Ubuntu não é mais suportada.

A execução do .NET nesta versão do Ubuntu não é mais suportada.

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

As seguintes versões do .NET foram suportadas ou disponíveis para o Ubuntu 23.04:

Versões .NET suportadas Available in
built-in Ubuntu feed		 Disponível em
Backports .NET
Feed do Ubuntu		 Disponível em
Feed da Microsoft
8.0, 6.0 7.0, 6.0 Nenhuma 8.0, 7.0, 6.0

Importante

Se você estiver usando o SDK do .NET 8 e o 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 recursos, use o feed da Microsoft para instalar o SDK. Certifique-se de revisar as informações no artigo Misturas de pacotes .NET no Linux para entender as implicações da alternância entre feeds de repositório.

Não disponível.

Dependências

Quando você instala com um gerenciador de pacotes, essas bibliotecas são instaladas para você. Mas, se você instalar manualmente o .NET ou publicar um aplicativo independente, precisará garantir que essas bibliotecas estejam instaladas:

  • Certificados CA
  • libc6
  • libgcc-s1
  • libgssapi-krb5-2
  • Libicu72
  • liblttng-ust1
  • libssl3
  • libstdc++6
  • libunwind8
  • Zlib1g

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

sudo apt install zlib1g

Se o aplicativo .NET usa o assembly System.Drawing.Common , o libgdiplus também precisará ser instalado. Como System.Drawing.Common não é mais suportado no Linux, isso só funciona no .NET 6 e requer a configuração da opção de configuração de System.Drawing.EnableUnixSupport tempo de execução.

Você pode instalar uma versão recente do libgdiplus adicionando o repositório Mono ao seu sistema.

Ubuntu 22,10

Aviso

Esta versão do Ubuntu não é mais suportada.

A execução do .NET nesta versão do Ubuntu não é mais suportada.

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

As seguintes versões do .NET são suportadas ou estão disponíveis para o Ubuntu 22.10:

Versões .NET suportadas Available in
built-in Ubuntu feed		 Disponível em
Backports .NET
Feed do Ubuntu		 Disponível em
Feed da Microsoft
6,0 7.0, 6.0 Nenhuma 7.0, 6.0, 3.1

Importante

Se você estiver usando o SDK do .NET 8 e o 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 recursos, use o feed da Microsoft para instalar o SDK. Certifique-se de revisar as informações no artigo Misturas de pacotes .NET no Linux para entender as implicações da alternância entre feeds de repositório.

Não disponível.

Dependências

Quando você instala com um gerenciador de pacotes, essas bibliotecas são instaladas para você. Mas, se você instalar manualmente o .NET ou publicar um aplicativo independente, precisará garantir que essas bibliotecas estejam instaladas:

  • Certificados CA
  • libc6
  • libgcc-s1
  • libgssapi-krb5-2
  • Libicu71
  • liblttng-ust1
  • libssl3
  • libstdc++6
  • libunwind8
  • Zlib1g

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

sudo apt install zlib1g

Se o aplicativo .NET usa o assembly System.Drawing.Common , o libgdiplus também precisará ser instalado. Como System.Drawing.Common não é mais suportado no Linux, isso só funciona no .NET 6 e requer a configuração da opção de configuração de System.Drawing.EnableUnixSupport tempo de execução.

Você pode instalar uma versão recente do libgdiplus adicionando o repositório Mono ao seu sistema.

Próximos passos