Instalar o SDK do .NET ou o Runtime do .NET no Ubuntu

Há suporte para o .NET no Ubuntu. Este artigo descreve como instalar o .NET no Ubuntu. Quando uma versão do Ubuntu fica sem suporte, o .NET não tem mais suporte com essa versão.

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

Se você já tiver instalado o SDK ou tempo de execução, use os dotnet --list-sdks dotnet --list-runtimes comandos e para ver quais versões estão instaladas. Para obter mais informações, consulte como verificar se o .net já está instalado.

Importante

As instalação do gerenciador de pacotes só têm suporte na arquitetura x64. Outras arquiteturas, como ARM, devem instalar o .NET por alguns outros meios, como com o Snap, um script do instalador ou por meio de uma instalação binária manual.

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

Distribuições com suporte

A tabela a seguir é uma lista de versões do .NET com suporte no momento e as versões do Ubuntu nas que têm suporte. Essas versões permanecem com suporte até que a versão do .NET atinja o fim do suporte ou a versão do Ubuntuatinja o fim da vida útil.

  • Um ✔️ indica que a versão do Ubuntu ou do .NET ainda tem suporte.
  • Um indica que não há suporte para a versão do ❌ Ubuntu ou do .NET nessa versão do Ubuntu.
  • Quando uma versão do Ubuntu e uma versão do .NET ✔️, há suporte para essa combinação de sistema operacional e .NET.
Ubuntu .NET Core 3.1 .NET 5 .NET 6
✔️ 21.10 ✔️ 3.1 ✔️ 5.0 ✔️ 6.0
✔️ 21.04 ✔️ 3.1 ✔️ 5.0 ✔️ 6.0
20.10 ✔️ 3.1 ✔️ 5.0 ❌ 6.0
✔️ LTS (20.04) ✔️ 3.1 ✔️ 5.0 ✔️ 6.0
19.10 ✔️ 3.1 ❌ 5.0 ❌ 6.0
19.04 ✔️ 3.1 ❌ 5.0 ❌ 6.0
18.10 ❌ 3.1 ❌ 5.0 ❌ 6.0
✔️ LTS (18.04) ✔️ 3.1 ✔️ 5.0 ✔️ 6.0
17.10 ❌ 3.1 ❌ 5.0 ❌ 6.0
17.04 ❌ 3.1 ❌ 5.0 ❌ 6.0
16,10 ❌ 3.1 ❌ 5.0 ❌ 6.0
✔️ LTS (16.04) ✔️ 3.1 ✔️ 5.0 ✔️ 6.0

Não há mais suporte para as versões a ❌ seguir do .NET. Os downloads para eles ainda permanecem publicados:

  • .NET Core 3.0
  • .NET Core 2.2
  • .NET Core 2.1
  • .NET Core 2.0

Instalar versões prévias

As versões prévia e release candidate do .NET não estão disponíveis nos gerenciadores de pacotes. Você pode instalar versões prévias e lançar candidatos do .NET de uma das seguintes maneiras:

Remover versões prévias

Ao usar um Gerenciador de pacotes para gerenciar a instalação do .NET, você poderá se deparar com um conflito se tiver instalado anteriormente uma versão de visualização. O Gerenciador de pacotes pode interpretar a versão sem visualização como uma versão anterior do .NET. Para instalar a versão sem visualização, primeiro desinstale as versões de visualização. Para obter mais informações sobre como desinstalar o .NET, consulte como remover o tempo de execução e o SDK do .net.

21.10 ✔️

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

Abra um terminal e execute os seguintes comandos:

Observação

Os pacotes do .NET 6 ainda não foram publicados para o Ubuntu 21.10. O comando wget a seguir usa o repositório Ubuntu 21.04. Este artigo será atualizado quando os pacotes estão disponíveis no repositório Ubuntu 21.10.

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

Instalar 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 runtime correspondente. Para instalar o SDK do .NET, execute os seguintes comandos:

sudo apt-get update; \
  sudo apt-get install -y apt-transport-https && \
  sudo apt-get update && \
  sudo apt-get install -y dotnet-sdk-6.0

Importante

Se você receber uma mensagem de erro semelhante a Não é possível localizar o pacote dotnet-sdk-6.0, consulte a seção Solução de problemas do APT.

Instalar o runtime

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

sudo apt-get update; \
  sudo apt-get install -y apt-transport-https && \
  sudo apt-get update && \
  sudo apt-get install -y aspnetcore-runtime-6.0

Importante

Se você receber uma mensagem de erro semelhante a Não é possível localizar o pacote aspnetcore-runtime-6.0, consulte a seção Solução de problemas do APT.

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

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

21,04 ✔️

A instalação com APT pode ser feita com alguns comandos. Antes de instalar o .NET, execute os comandos a seguir para adicionar a chave de assinatura do pacote da Microsoft à 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/21.04/packages-microsoft-prod.deb -O packages-microsoft-prod.deb
sudo dpkg -i packages-microsoft-prod.deb
rm packages-microsoft-prod.deb

Instalar 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 runtime correspondente. Para instalar o SDK do .NET, execute os seguintes comandos:

sudo apt-get update; \
  sudo apt-get install -y apt-transport-https && \
  sudo apt-get update && \
  sudo apt-get install -y dotnet-sdk-6.0

Importante

Se você receber uma mensagem de erro semelhante a Não é possível localizar o pacote dotnet-sdk-6.0, consulte a seção Solução de problemas do APT.

Instalar o runtime

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

sudo apt-get update; \
  sudo apt-get install -y apt-transport-https && \
  sudo apt-get update && \
  sudo apt-get install -y aspnetcore-runtime-6.0

Importante

Se você receber uma mensagem de erro semelhante a Não é possível localizar o pacote aspnetcore-runtime-6.0, consulte a seção Solução de problemas do APT.

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

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

20.10 ❌

❌ Observe que esta versão do Ubuntu não é mais suportada.

A instalação com APT pode ser feita com alguns comandos. Antes de instalar o .NET, execute os comandos a seguir para adicionar a chave de assinatura do pacote da Microsoft à 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.10/packages-microsoft-prod.deb -O packages-microsoft-prod.deb
sudo dpkg -i packages-microsoft-prod.deb
rm packages-microsoft-prod.deb

Instalar 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 apt-transport-https && \
  sudo apt-get update && \
  sudo apt-get install -y dotnet-sdk-5.0

Importante

Se você receber uma mensagem de erro semelhante a não é possível localizar o pacote dotnet-SDK-5,0 , consulte a seção solução de problemas da apt .

Instalar o runtime

O tempo de execução de ASP.NET Core permite que você execute aplicativos que foram feitos com o .NET que não forneceu o tempo de execução. Os comandos a seguir instalam o tempo de execução do ASP.NET Core, que é o tempo de execução mais compatível para o .NET. Em seu terminal, execute os seguintes comandos:

sudo apt-get update; \
  sudo apt-get install -y apt-transport-https && \
  sudo apt-get update && \
  sudo apt-get install -y aspnetcore-runtime-5.0

Importante

Se você receber uma mensagem de erro semelhante a não é possível localizar o pacote aspnetcore-Runtime-5,0 , consulte a seção solução de problemas da apt .

Como alternativa ao tempo de execução de ASP.NET Core, você pode instalar o tempo de execução do .NET, que não inclui suporte a ASP.NET Core: substitua aspnetcore-runtime-5.0 no comando anterior por dotnet-runtime-5.0 :

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

20,04 ✔️

A instalação com APT pode ser feita com alguns comandos. Antes de instalar o .NET, execute os comandos a seguir para adicionar a chave de assinatura do pacote da Microsoft à 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

Instalar 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 runtime correspondente. Para instalar o SDK do .NET, execute os seguintes comandos:

sudo apt-get update; \
  sudo apt-get install -y apt-transport-https && \
  sudo apt-get update && \
  sudo apt-get install -y dotnet-sdk-6.0

Importante

Se você receber uma mensagem de erro semelhante a Não é possível localizar o pacote dotnet-sdk-6.0, consulte a seção Solução de problemas do APT.

Instalar o runtime

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

sudo apt-get update; \
  sudo apt-get install -y apt-transport-https && \
  sudo apt-get update && \
  sudo apt-get install -y aspnetcore-runtime-6.0

Importante

Se você receber uma mensagem de erro semelhante a Não é possível localizar o pacote aspnetcore-runtime-6.0, consulte a seção Solução de problemas do APT.

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

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

19.10 ❌

❌ Observe que esta versão do Ubuntu não é mais suportada.

A instalação com APT pode ser feita com alguns comandos. Antes de instalar o .NET, execute os comandos a seguir para adicionar a chave de assinatura do pacote da Microsoft à 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/19.10/packages-microsoft-prod.deb -O packages-microsoft-prod.deb
sudo dpkg -i packages-microsoft-prod.deb
rm packages-microsoft-prod.deb

Instalar o SDK

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

sudo apt-get update; \
  sudo apt-get install -y apt-transport-https && \
  sudo apt-get update && \
  sudo apt-get install -y dotnet-sdk-3.1

Importante

Se você receber uma mensagem de erro semelhante a não é possível localizar o pacote dotnet-SDK-3,1 , consulte a seção solução de problemas da apt .

Instalar o runtime

O tempo de execução do .NET Core permite executar aplicativos que foram feitos com o .NET Core que não incluiu o tempo de execução. Os comandos a seguir instalam o tempo de execução do ASP.NET Core, que é o tempo de execução mais compatível para o .NET Core. Em seu terminal, execute os comandos a seguir.

sudo apt-get update; \
  sudo apt-get install -y apt-transport-https && \
  sudo apt-get update && \
  sudo apt-get install -y aspnetcore-runtime-3.1

Importante

Se você receber uma mensagem de erro semelhante a não é possível localizar o pacote aspnetcore-Runtime-3,1 , consulte a seção solução de problemas da apt .

Como alternativa ao tempo de execução de ASP.NET Core, você pode instalar o tempo de execução do .NET Core, que não inclui suporte a ASP.NET Core: substitua aspnetcore-runtime-3.1 no comando anterior por dotnet-runtime-3.1 .

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

19.04 ❌

❌ Observe que esta versão do Ubuntu não é mais suportada.

A instalação com APT pode ser feita com alguns comandos. Antes de instalar o .NET, execute os comandos a seguir para adicionar a chave de assinatura do pacote da Microsoft à 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/19.04/packages-microsoft-prod.deb -O packages-microsoft-prod.deb
sudo dpkg -i packages-microsoft-prod.deb
rm packages-microsoft-prod.deb

Instalar o SDK

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

sudo apt-get update; \
  sudo apt-get install -y apt-transport-https && \
  sudo apt-get update && \
  sudo apt-get install -y dotnet-sdk-3.1

Importante

Se você receber uma mensagem de erro semelhante a não é possível localizar o pacote dotnet-SDK-3,1 , consulte a seção solução de problemas da apt .

Instalar o runtime

O tempo de execução do .NET Core permite executar aplicativos que foram feitos com o .NET Core que não incluiu o tempo de execução. Os comandos a seguir instalam o tempo de execução do ASP.NET Core, que é o tempo de execução mais compatível para o .NET Core. Em seu terminal, execute os comandos a seguir.

sudo apt-get update; \
  sudo apt-get install -y apt-transport-https && \
  sudo apt-get update && \
  sudo apt-get install -y aspnetcore-runtime-3.1

Importante

Se você receber uma mensagem de erro semelhante a não é possível localizar o pacote aspnetcore-Runtime-3,1 , consulte a seção solução de problemas da apt .

Como alternativa ao tempo de execução de ASP.NET Core, você pode instalar o tempo de execução do .NET Core, que não inclui suporte a ASP.NET Core: substitua aspnetcore-runtime-3.1 no comando anterior por dotnet-runtime-3.1 .

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

18.10 ❌

❌ Observe que esta versão do Ubuntu não é mais suportada.

A instalação com APT pode ser feita com alguns comandos. Antes de instalar o .NET, execute os comandos a seguir para adicionar a chave de assinatura do pacote da Microsoft à 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/18.10/packages-microsoft-prod.deb -O packages-microsoft-prod.deb
sudo dpkg -i packages-microsoft-prod.deb
rm packages-microsoft-prod.deb

Instalar o SDK

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

sudo apt-get update; \
  sudo apt-get install -y apt-transport-https && \
  sudo apt-get update && \
  sudo apt-get install -y dotnet-sdk-2.1

Importante

Se você receber uma mensagem de erro semelhante a não é possível localizar o pacote dotnet-SDK-2,1 , consulte a seção solução de problemas da apt .

Instalar o runtime

O tempo de execução do .NET Core permite executar aplicativos que foram feitos com o .NET Core que não incluiu o tempo de execução. Os comandos a seguir instalam o tempo de execução do ASP.NET Core, que é o tempo de execução mais compatível para o .NET Core. Em seu terminal, execute os comandos a seguir.

sudo apt-get update; \
  sudo apt-get install -y apt-transport-https && \
  sudo apt-get update && \
  sudo apt-get install -y aspnetcore-runtime-2.1

Importante

Se você receber uma mensagem de erro semelhante a não é possível localizar o pacote aspnetcore-Runtime-2,1 , consulte a seção solução de problemas da apt .

Como alternativa ao tempo de execução de ASP.NET Core, você pode instalar o tempo de execução do .NET Core, que não inclui suporte a ASP.NET Core: substitua aspnetcore-runtime-2.1 no comando anterior por dotnet-runtime-2.1 .

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

18,04 ✔️

A instalação com APT pode ser feita com alguns comandos. Antes de instalar o .NET, execute os comandos a seguir para adicionar a chave de assinatura do pacote da Microsoft à 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/18.04/packages-microsoft-prod.deb -O packages-microsoft-prod.deb
sudo dpkg -i packages-microsoft-prod.deb
rm packages-microsoft-prod.deb

Instalar 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 runtime correspondente. Para instalar o SDK do .NET, execute os seguintes comandos:

sudo apt-get update; \
  sudo apt-get install -y apt-transport-https && \
  sudo apt-get update && \
  sudo apt-get install -y dotnet-sdk-6.0

Importante

Se você receber uma mensagem de erro semelhante a Não é possível localizar o pacote dotnet-sdk-6.0, consulte a seção Solução de problemas do APT.

Instalar o runtime

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

sudo apt-get update; \
  sudo apt-get install -y apt-transport-https && \
  sudo apt-get update && \
  sudo apt-get install -y aspnetcore-runtime-6.0

Importante

Se você receber uma mensagem de erro semelhante a Não é possível localizar o pacote aspnetcore-runtime-6.0, consulte a seção Solução de problemas do APT.

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

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

17.10 ❌

❌ Observe que esta versão do Ubuntu não é mais suportada.

A instalação com APT pode ser feita com alguns comandos. Antes de instalar o .NET, execute os comandos a seguir para adicionar a chave de assinatura do pacote da Microsoft à 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/17.10/packages-microsoft-prod.deb -O packages-microsoft-prod.deb
sudo dpkg -i packages-microsoft-prod.deb
rm packages-microsoft-prod.deb

Instalar o SDK

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

sudo apt-get update; \
  sudo apt-get install -y apt-transport-https && \
  sudo apt-get update && \
  sudo apt-get install -y dotnet-sdk-2.1

Importante

Se você receber uma mensagem de erro semelhante a não é possível localizar o pacote dotnet-SDK-2,1 , consulte a seção solução de problemas da apt .

Instalar o runtime

O tempo de execução do .NET Core permite executar aplicativos que foram feitos com o .NET Core que não incluiu o tempo de execução. Os comandos a seguir instalam o tempo de execução do ASP.NET Core, que é o tempo de execução mais compatível para o .NET Core. Em seu terminal, execute os comandos a seguir.

sudo apt-get update; \
  sudo apt-get install -y apt-transport-https && \
  sudo apt-get update && \
  sudo apt-get install -y aspnetcore-runtime-2.1

Importante

Se você receber uma mensagem de erro semelhante a não é possível localizar o pacote aspnetcore-Runtime-2,1 , consulte a seção solução de problemas da apt .

Como alternativa ao tempo de execução de ASP.NET Core, você pode instalar o tempo de execução do .NET Core, que não inclui suporte a ASP.NET Core: substitua aspnetcore-runtime-2.1 no comando anterior por dotnet-runtime-2.1 .

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

17.04 ❌

❌ Observe que esta versão do Ubuntu não é mais suportada.

A instalação com APT pode ser feita com alguns comandos. Antes de instalar o .NET, execute os comandos a seguir para adicionar a chave de assinatura do pacote da Microsoft à 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/17.04/packages-microsoft-prod.deb -O packages-microsoft-prod.deb
sudo dpkg -i packages-microsoft-prod.deb
rm packages-microsoft-prod.deb

Instalar o SDK

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

sudo apt-get update; \
  sudo apt-get install -y apt-transport-https && \
  sudo apt-get update && \
  sudo apt-get install -y dotnet-sdk-2.1

Importante

Se você receber uma mensagem de erro semelhante a não é possível localizar o pacote dotnet-SDK-2,1 , consulte a seção solução de problemas da apt .

Instalar o runtime

O tempo de execução do .NET Core permite executar aplicativos que foram feitos com o .NET Core que não incluiu o tempo de execução. Os comandos a seguir instalam o tempo de execução do ASP.NET Core, que é o tempo de execução mais compatível para o .NET Core. Em seu terminal, execute os comandos a seguir.

sudo apt-get update; \
  sudo apt-get install -y apt-transport-https && \
  sudo apt-get update && \
  sudo apt-get install -y aspnetcore-runtime-2.1

Importante

Se você receber uma mensagem de erro semelhante a não é possível localizar o pacote aspnetcore-Runtime-2,1 , consulte a seção solução de problemas da apt .

Como alternativa ao tempo de execução de ASP.NET Core, você pode instalar o tempo de execução do .NET Core, que não inclui suporte a ASP.NET Core: substitua aspnetcore-runtime-2.1 no comando anterior por dotnet-runtime-2.1 .

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

16.10 ❌

❌ Observe que esta versão do Ubuntu não é mais suportada.

A instalação com APT pode ser feita com alguns comandos. Antes de instalar o .NET, execute os comandos a seguir para adicionar a chave de assinatura do pacote da Microsoft à 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/16.10/packages-microsoft-prod.deb -O packages-microsoft-prod.deb
sudo dpkg -i packages-microsoft-prod.deb
rm packages-microsoft-prod.deb

Instalar o SDK

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

sudo apt-get update; \
  sudo apt-get install -y apt-transport-https && \
  sudo apt-get update && \
  sudo apt-get install -y dotnet-sdk-2.1

Importante

Se você receber uma mensagem de erro semelhante a não é possível localizar o pacote dotnet-SDK-2,1 , consulte a seção solução de problemas da apt .

Instalar o runtime

O tempo de execução do .NET Core permite executar aplicativos que foram feitos com o .NET Core que não incluiu o tempo de execução. Os comandos a seguir instalam o tempo de execução do ASP.NET Core, que é o tempo de execução mais compatível para o .NET Core. Em seu terminal, execute os comandos a seguir.

sudo apt-get update; \
  sudo apt-get install -y apt-transport-https && \
  sudo apt-get update && \
  sudo apt-get install -y aspnetcore-runtime-2.1

Importante

Se você receber uma mensagem de erro semelhante a não é possível localizar o pacote aspnetcore-Runtime-2,1 , consulte a seção solução de problemas da apt .

Como alternativa ao tempo de execução de ASP.NET Core, você pode instalar o tempo de execução do .NET Core, que não inclui suporte a ASP.NET Core: substitua aspnetcore-runtime-2.1 no comando anterior por dotnet-runtime-2.1 .

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

16,04 ✔️

A instalação com APT pode ser feita com alguns comandos. Antes de instalar o .NET, execute os comandos a seguir para adicionar a chave de assinatura do pacote da Microsoft à 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/16.04/packages-microsoft-prod.deb -O packages-microsoft-prod.deb
sudo dpkg -i packages-microsoft-prod.deb
rm packages-microsoft-prod.deb

Instalar 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 runtime correspondente. Para instalar o SDK do .NET, execute os seguintes comandos:

sudo apt-get update; \
  sudo apt-get install -y apt-transport-https && \
  sudo apt-get update && \
  sudo apt-get install -y dotnet-sdk-6.0

Importante

Se você receber uma mensagem de erro semelhante a Não é possível localizar o pacote dotnet-sdk-6.0, consulte a seção Solução de problemas do APT.

Instalar o runtime

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

sudo apt-get update; \
  sudo apt-get install -y apt-transport-https && \
  sudo apt-get update && \
  sudo apt-get install -y aspnetcore-runtime-6.0

Importante

Se você receber uma mensagem de erro semelhante a Não é possível localizar o pacote aspnetcore-runtime-6.0, consulte a seção Solução de problemas do APT.

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

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

Como instalar outras versões

Todas as versões do .NET estão disponíveis para download em https://dotnet.microsoft.com/download/dotnet , mas exigem a 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
  • Tipo
    Escolhe o SDK ou o runtime. As opções válidas são:

    • sdk
    • runtime
  • Versão
    A versão do SDK ou runtime a ser instalada. Este artigo sempre dará as instruções para a versão mais recente com suporte. As opções válidas são qualquer versão lançada, como:

    • 5,0
    • 3.1
    • 3,0
    • 2.1

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

Exemplos

  • Instale o runtime ASP.NET Core 5.0:aspnetcore-runtime-5.0
  • Instale o runtime 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

Pacote ausente

Se a combinação de versão do pacote não funcionar, ela não estará disponível. Por exemplo, não há um SDK ASP.NET Core, os componentes do SDK são incluídos com o SDK do .NET. O valor aspnetcore-sdk-2.2 está incorreto e deve ser dotnet-sdk-2.2 . Para ver uma lista das distribuições do Linux com suporte no .NET, confira Requisitos e dependências do .NET.

Usar o APT para atualizar o .NET

Quando uma nova versão de patch estiver disponível para .NET, você poderá simplesmente atualize-a por meio do APT com os seguintes comandos:

sudo apt-get update
sudo apt-get upgrade

Se você atualizou sua distribuição do Linux desde a instalação do .NET, talvez seja necessário reconfigurar o repositório de pacotes da Microsoft. Execute as instruções de instalação da versão de distribuição atual para atualizar para o repositório de pacotes apropriado para atualizações do .NET.

Solução de problemas do APT

Esta seção fornece informações sobre erros comuns que você pode obter ao usar o APT para instalar o .NET.

Não é possível encontrar o pacote

Importante

As instalação do gerenciador de pacotes só têm suporte na arquitetura x64. Outras arquiteturas, como ARM, devem instalar o .NET por alguns outros meios, como com o Snap, um script do instalador ou por meio de uma instalação binária manual.

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

Não foi possível localizar \ Alguns pacotes não puderam ser instalados

Se você receber uma mensagem de erro semelhante a não é possível localizar o pacote {dotnet-Package} ou não foi possível instalar alguns pacotes, execute os comandos a seguir.

Há dois espaços reservados no seguinte conjunto de comandos.

  • {dotnet-package}
    Isso representa o pacote .NET que você está instalando, como aspnetcore-runtime-3.1 . Isso é usado no comando a seguir sudo apt-get install .

  • {os-version}
    Isso representa a versão de distribuição em que você está. Isso é usado no wget comando a seguir. A versão de distribuição é o valor numérico, como 20.04 no Ubuntu ou 10 no Debian.

Primeiro, tente limpar a lista de pacotes:

sudo dpkg --purge packages-microsoft-prod && sudo dpkg -i packages-microsoft-prod.deb
sudo apt-get update

Em seguida, tente instalar o .NET novamente. Se isso não funcionar, você poderá executar uma instalação manual com os seguintes comandos:

sudo apt-get install -y gpg
wget -O - https://packages.microsoft.com/keys/microsoft.asc | gpg --dearmor -o microsoft.asc.gpg
sudo mv microsoft.asc.gpg /etc/apt/trusted.gpg.d/
wget https://packages.microsoft.com/config/ubuntu/{os-version}/prod.list
sudo mv prod.list /etc/apt/sources.list.d/microsoft-prod.list
sudo chown root:root /etc/apt/trusted.gpg.d/microsoft.asc.gpg
sudo chown root:root /etc/apt/sources.list.d/microsoft-prod.list
sudo apt-get update; \
  sudo apt-get install -y apt-transport-https && \
  sudo apt-get update && \
  sudo apt-get install -y {dotnet-package}

Falha ao buscar

Ao instalar o pacote .NET, você poderá ver um erro semelhante a Failed to fetch ... File has unexpected size ... Mirror sync in progress? . Esse erro pode significar que o feed de pacote para .NET está sendo atualizado com versões mais recentes do pacote e que você deve tentar novamente mais tarde. Durante uma atualização, o feed de pacote não deve ficar indisponível por mais de 30 minutos. Se você receber esse erro continuamente por mais de 30 minutos, registre um problema em https://github.com/dotnet/core/issues .

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 autossunte, precisará garantir que essas bibliotecas sejam instaladas:

  • libc6
  • libgcc1
  • libgssapi-krb5-2
  • libicu52 (para 14.x)
  • libicu55 (para 16.x)
  • libicu60 (para 18.x)
  • libicu66 (para 20. x)
  • libssl 1.0.0 (para 14. x, 16. x)
  • libssl 1.1 (para 18. x, 20. x)
  • libstdc + + 6
  • zlib1g

Para aplicativos .NET que usam o assembly System. Drawing. Common , você também precisa da seguinte dependência:

  • libgdiplus (versão 6.0.1 ou posterior)

    Aviso

    Você pode instalar uma versão recente do libgdiplus adicionando o repositório do mono ao seu sistema. Para obter mais informações, consulte https://www.mono-project.com/download/stable/.

Próximas etapas