Instalar o SDK do .NET ou o tempo de execução do .NET no UbuntuInstall the .NET SDK or the .NET Runtime on Ubuntu

O .NET tem suporte no Ubuntu..NET is supported on Ubuntu. Este artigo descreve como instalar o .NET no Ubuntu.This article describes how to install .NET on Ubuntu. Quando uma versão do Ubuntu ficar sem suporte, o .NET não terá mais suporte com essa versão.When an Ubuntu version falls out of support, .NET is no longer supported with that version.

Instale o SDK (que inclui o tempo de execução) se você quiser desenvolver aplicativos .NET.Install the SDK (which includes the runtime) if you want to develop .NET apps. Ou, se você só precisa executar aplicativos, instale o tempo de execução.Or, if you only need to run apps, install the Runtime. 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.If you're installing the Runtime, we suggest you install the ASP.NET Core Runtime as it includes both .NET and 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.If you've already installed the SDK or Runtime, use the dotnet --list-sdks and dotnet --list-runtimes commands to see which versions are installed. Para obter mais informações, consulte como verificar se o .net já está instalado.For more information, see How to check that .NET is already installed.

Importante

As instalações do Gerenciador de pacotes têm suporte apenas na arquitetura x64 .Package manager installs are only supported on the x64 architecture. Outras arquiteturas, como o ARM, devem instalar o .net por outros meios, como com snap, um script de instalador ou por meio de uma instalação manual binária.Other architectures, such as ARM, must install .NET by some other means such as with Snap, an installer script, or through a manual binary installation.

Para obter mais informações sobre como instalar o .NET sem um Gerenciador de pacotes, consulte um dos seguintes artigos:For more information on installing .NET without a package manager, see one of the following articles:

Distribuições com suporteSupported distributions

A tabela a seguir é uma lista de versões do .NET com suporte no momento e as versões do Ubuntu nas quais elas têm suporte.The following table is a list of currently supported .NET releases and the versions of Ubuntu they're supported on. Essas versões permanecem com suporte até que a versão do .net atinja o fim do suporte ou a versão do Ubuntu atinja o fim da vida útil.These versions remain supported until either the version of .NET reaches end-of-support or the version of Ubuntu reaches end-of-life.

  • Um ✔️ indica que a versão do Ubuntu ou do .NET ainda tem suporte.A ✔️ indicates that the version of Ubuntu or .NET is still supported.
  • Um ❌ indica que a versão do Ubuntu ou do .net não tem suporte nessa versão do Ubuntu.A ❌ indicates that the version of Ubuntu or .NET isn't supported on that Ubuntu release.
  • Quando uma versão do Ubuntu e uma versão do .NET têm ✔️, essa combinação de so e .NET é suportada.When both a version of Ubuntu and a version of .NET have ✔️, that OS and .NET combination is supported.
UbuntuUbuntu .NET Core 2.1.NET Core 2.1 .NET Core 3.1.NET Core 3.1 .NET 5.0.NET 5.0
✔️ 20,10✔️ 20.10 ✔️ 2,1✔️ 2.1 ✔️ 3,1✔️ 3.1 ✔️ 5,0✔️ 5.0
✔️ 20, 4 (LTS)✔️ 20.04 (LTS) ✔️ 2,1✔️ 2.1 ✔️ 3,1✔️ 3.1 ✔️ 5,0✔️ 5.0
19,1019.10 ✔️ 2,1✔️ 2.1 ✔️ 3,1✔️ 3.1 ✔️ 5,0✔️ 5.0
19, 419.04 ✔️ 2,1✔️ 2.1 ✔️ 3,1✔️ 3.1 ❌ 5,0❌ 5.0
18,1018.10 ✔️ 2,1✔️ 2.1 ❌ 3,1❌ 3.1 ❌ 5,0❌ 5.0
✔️ 18, 4 (LTS)✔️ 18.04 (LTS) ✔️ 2,1✔️ 2.1 ✔️ 3,1✔️ 3.1 ✔️ 5,0✔️ 5.0
17.1017.10 ✔️ 2,1✔️ 2.1 ❌ 3,1❌ 3.1 ❌ 5,0❌ 5.0
17.0417.04 ✔️ 2,1✔️ 2.1 ❌ 3,1❌ 3.1 ❌ 5,0❌ 5.0
16.1016.10 ❌ 2,1❌ 2.1 ❌ 3,1❌ 3.1 ❌ 5,0❌ 5.0
✔️ 16, 4 (LTS)✔️ 16.04 (LTS) ✔️ 2,1✔️ 2.1 ✔️ 3,1✔️ 3.1 ✔️ 5,0✔️ 5.0

Não há mais suporte para as seguintes versões do .NET.The following versions of .NET are no longer supported. Os downloads para eles ainda permanecem publicados:The downloads for these still remain published:

  • 3.03.0
  • 2.22.2
  • 2,02.0

Remover versões de visualizaçãoRemove preview versions

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.When using a package manager to manage your installation of .NET, you may run into a conflict if you've previously installed a preview release. O Gerenciador de pacotes pode interpretar a versão sem visualização como uma versão anterior do .NET.The package manager may interpret the non-preview release as an earlier version of .NET. Para instalar a versão sem visualização, primeiro desinstale as versões de visualização.To install the non-preview release, first uninstall the preview versions. Para obter mais informações sobre como desinstalar o .NET, consulte como remover o tempo de execução e o SDK do .net.For more information about uninstalling .NET, see How to remove the .NET Runtime and SDK.

20,10 ✔️20.10 ✔️

A instalação com APT pode ser feita com alguns comandos.Installing with APT can be done with a few commands. 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.Before you install .NET, run the following commands to add the Microsoft package signing key to your list of trusted keys and add the package repository.

Abra um terminal e execute os seguintes comandos:Open a terminal and run the following commands:

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

Instalar o SDKInstall the SDK

O SDK do .NET permite que você desenvolva aplicativos com o .NET.The .NET SDK allows you to develop apps with .NET. Se você instalar o SDK do .NET, não precisará instalar o tempo de execução correspondente.If you install the .NET SDK, you don't need to install the corresponding runtime. Para instalar o SDK do .NET, execute os seguintes comandos:To install the .NET SDK, run the following commands:

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 .If you receive an error message similar to Unable to locate package dotnet-sdk-5.0 , see the APT troubleshooting section.

Instalar o runtimeInstall the 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.The ASP.NET Core Runtime allows you to run apps that were made with .NET that didn't provide the runtime. 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.The following commands install the ASP.NET Core Runtime, which is the most compatible runtime for .NET. Em seu terminal, execute os seguintes comandos:In your terminal, run the following commands:

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 .If you receive an error message similar to Unable to locate package aspnetcore-runtime-5.0 , see the APT troubleshooting section.

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 :As an alternative to the ASP.NET Core Runtime, you can install the .NET Runtime, which doesn't include ASP.NET Core support: replace aspnetcore-runtime-5.0 in the previous command with dotnet-runtime-5.0:

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

20, 4 ✔️20.04 ✔️

A instalação com APT pode ser feita com alguns comandos.Installing with APT can be done with a few commands. 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.Before you install .NET, run the following commands to add the Microsoft package signing key to your list of trusted keys and add the package repository.

Abra um terminal e execute os seguintes comandos:Open a terminal and run the following commands:

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

Instalar o SDKInstall the SDK

O SDK do .NET permite que você desenvolva aplicativos com o .NET.The .NET SDK allows you to develop apps with .NET. Se você instalar o SDK do .NET, não precisará instalar o tempo de execução correspondente.If you install the .NET SDK, you don't need to install the corresponding runtime. Para instalar o SDK do .NET, execute os seguintes comandos:To install the .NET SDK, run the following commands:

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 .If you receive an error message similar to Unable to locate package dotnet-sdk-5.0 , see the APT troubleshooting section.

Instalar o runtimeInstall the 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.The ASP.NET Core Runtime allows you to run apps that were made with .NET that didn't provide the runtime. 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.The following commands install the ASP.NET Core Runtime, which is the most compatible runtime for .NET. Em seu terminal, execute os seguintes comandos:In your terminal, run the following commands:

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 .If you receive an error message similar to Unable to locate package aspnetcore-runtime-5.0 , see the APT troubleshooting section.

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 :As an alternative to the ASP.NET Core Runtime, you can install the .NET Runtime, which doesn't include ASP.NET Core support: replace aspnetcore-runtime-5.0 in the previous command with dotnet-runtime-5.0:

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

19,10 ❌19.10 ❌

❌ Observe que esta versão do Ubuntu não é mais suportada.❌ Please note that this version of Ubuntu is no longer supported.

A instalação com APT pode ser feita com alguns comandos.Installing with APT can be done with a few commands. 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.Before you install .NET, run the following commands to add the Microsoft package signing key to your list of trusted keys and add the package repository.

Abra um terminal e execute os seguintes comandos:Open a terminal and run the following commands:

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

Instalar o SDKInstall the SDK

O SDK do .NET Core permite que você desenvolva aplicativos com o .NET Core.The .NET Core SDK allows you to develop apps with .NET Core. Se você instalar o SDK do .NET Core, não será necessário instalar o tempo de execução correspondente.If you install the .NET Core SDK, you don't need to install the corresponding runtime. Para instalar o SDK do .NET Core, execute os seguintes comandos:To install the .NET Core SDK, run the following commands:

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 .If you receive an error message similar to Unable to locate package dotnet-sdk-3.1 , see the APT troubleshooting section.

Instalar o runtimeInstall the 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.The .NET Core Runtime allows you to run apps that were made with .NET Core that didn't include the runtime. 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.The following commands install the ASP.NET Core Runtime, which is the most compatible runtime for .NET Core. Em seu terminal, execute os comandos a seguir.In your terminal, run the following commands.

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 .If you receive an error message similar to Unable to locate package aspnetcore-runtime-3.1 , see the APT troubleshooting section.

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 .As an alternative to the ASP.NET Core Runtime, you can install the .NET Core Runtime, which doesn't include ASP.NET Core support: replace aspnetcore-runtime-3.1 in the previous command with dotnet-runtime-3.1.

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

19, 4 ❌19.04 ❌

❌ Observe que esta versão do Ubuntu não é mais suportada.❌ Please note that this version of Ubuntu is no longer supported.

A instalação com APT pode ser feita com alguns comandos.Installing with APT can be done with a few commands. 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.Before you install .NET, run the following commands to add the Microsoft package signing key to your list of trusted keys and add the package repository.

Abra um terminal e execute os seguintes comandos:Open a terminal and run the following commands:

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

Instalar o SDKInstall the SDK

O SDK do .NET Core permite que você desenvolva aplicativos com o .NET Core.The .NET Core SDK allows you to develop apps with .NET Core. Se você instalar o SDK do .NET Core, não será necessário instalar o tempo de execução correspondente.If you install the .NET Core SDK, you don't need to install the corresponding runtime. Para instalar o SDK do .NET Core, execute os seguintes comandos:To install the .NET Core SDK, run the following commands:

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 .If you receive an error message similar to Unable to locate package dotnet-sdk-3.1 , see the APT troubleshooting section.

Instalar o runtimeInstall the 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.The .NET Core Runtime allows you to run apps that were made with .NET Core that didn't include the runtime. 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.The following commands install the ASP.NET Core Runtime, which is the most compatible runtime for .NET Core. Em seu terminal, execute os comandos a seguir.In your terminal, run the following commands.

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 .If you receive an error message similar to Unable to locate package aspnetcore-runtime-3.1 , see the APT troubleshooting section.

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 .As an alternative to the ASP.NET Core Runtime, you can install the .NET Core Runtime, which doesn't include ASP.NET Core support: replace aspnetcore-runtime-3.1 in the previous command with dotnet-runtime-3.1.

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

18,10 ❌18.10 ❌

❌ Observe que esta versão do Ubuntu não é mais suportada.❌ Please note that this version of Ubuntu is no longer supported.

A instalação com APT pode ser feita com alguns comandos.Installing with APT can be done with a few commands. 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.Before you install .NET, run the following commands to add the Microsoft package signing key to your list of trusted keys and add the package repository.

Abra um terminal e execute os seguintes comandos:Open a terminal and run the following commands:

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

Instalar o SDKInstall the SDK

O SDK do .NET Core permite que você desenvolva aplicativos com o .NET Core.The .NET Core SDK allows you to develop apps with .NET Core. Se você instalar o SDK do .NET Core, não será necessário instalar o tempo de execução correspondente.If you install the .NET Core SDK, you don't need to install the corresponding runtime. Para instalar o SDK do .NET Core, execute os seguintes comandos:To install the .NET Core SDK, run the following commands:

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 .If you receive an error message similar to Unable to locate package dotnet-sdk-2.1 , see the APT troubleshooting section.

Instalar o runtimeInstall the 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.The .NET Core Runtime allows you to run apps that were made with .NET Core that didn't include the runtime. 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.The following commands install the ASP.NET Core Runtime, which is the most compatible runtime for .NET Core. Em seu terminal, execute os comandos a seguir.In your terminal, run the following commands.

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 .If you receive an error message similar to Unable to locate package aspnetcore-runtime-2.1 , see the APT troubleshooting section.

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 .As an alternative to the ASP.NET Core Runtime, you can install the .NET Core Runtime, which doesn't include ASP.NET Core support: replace aspnetcore-runtime-2.1 in the previous command with dotnet-runtime-2.1.

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

18, 4 ✔️18.04 ✔️

A instalação com APT pode ser feita com alguns comandos.Installing with APT can be done with a few commands. 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.Before you install .NET, run the following commands to add the Microsoft package signing key to your list of trusted keys and add the package repository.

Abra um terminal e execute os seguintes comandos:Open a terminal and run the following commands:

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

Instalar o SDKInstall the SDK

O SDK do .NET permite que você desenvolva aplicativos com o .NET.The .NET SDK allows you to develop apps with .NET. Se você instalar o SDK do .NET, não precisará instalar o tempo de execução correspondente.If you install the .NET SDK, you don't need to install the corresponding runtime. Para instalar o SDK do .NET, execute os seguintes comandos:To install the .NET SDK, run the following commands:

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 .If you receive an error message similar to Unable to locate package dotnet-sdk-5.0 , see the APT troubleshooting section.

Instalar o runtimeInstall the 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.The ASP.NET Core Runtime allows you to run apps that were made with .NET that didn't provide the runtime. 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.The following commands install the ASP.NET Core Runtime, which is the most compatible runtime for .NET. Em seu terminal, execute os seguintes comandos:In your terminal, run the following commands:

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 .If you receive an error message similar to Unable to locate package aspnetcore-runtime-5.0 , see the APT troubleshooting section.

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 :As an alternative to the ASP.NET Core Runtime, you can install the .NET Runtime, which doesn't include ASP.NET Core support: replace aspnetcore-runtime-5.0 in the previous command with dotnet-runtime-5.0:

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

17,10 ❌17.10 ❌

❌ Observe que esta versão do Ubuntu não é mais suportada.❌ Please note that this version of Ubuntu is no longer supported.

A instalação com APT pode ser feita com alguns comandos.Installing with APT can be done with a few commands. 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.Before you install .NET, run the following commands to add the Microsoft package signing key to your list of trusted keys and add the package repository.

Abra um terminal e execute os seguintes comandos:Open a terminal and run the following commands:

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

Instalar o SDKInstall the SDK

O SDK do .NET Core permite que você desenvolva aplicativos com o .NET Core.The .NET Core SDK allows you to develop apps with .NET Core. Se você instalar o SDK do .NET Core, não será necessário instalar o tempo de execução correspondente.If you install the .NET Core SDK, you don't need to install the corresponding runtime. Para instalar o SDK do .NET Core, execute os seguintes comandos:To install the .NET Core SDK, run the following commands:

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 .If you receive an error message similar to Unable to locate package dotnet-sdk-2.1 , see the APT troubleshooting section.

Instalar o runtimeInstall the 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.The .NET Core Runtime allows you to run apps that were made with .NET Core that didn't include the runtime. 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.The following commands install the ASP.NET Core Runtime, which is the most compatible runtime for .NET Core. Em seu terminal, execute os comandos a seguir.In your terminal, run the following commands.

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 .If you receive an error message similar to Unable to locate package aspnetcore-runtime-2.1 , see the APT troubleshooting section.

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 .As an alternative to the ASP.NET Core Runtime, you can install the .NET Core Runtime, which doesn't include ASP.NET Core support: replace aspnetcore-runtime-2.1 in the previous command with dotnet-runtime-2.1.

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

17, 4 ❌17.04 ❌

❌ Observe que esta versão do Ubuntu não é mais suportada.❌ Please note that this version of Ubuntu is no longer supported.

A instalação com APT pode ser feita com alguns comandos.Installing with APT can be done with a few commands. 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.Before you install .NET, run the following commands to add the Microsoft package signing key to your list of trusted keys and add the package repository.

Abra um terminal e execute os seguintes comandos:Open a terminal and run the following commands:

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

Instalar o SDKInstall the SDK

O SDK do .NET Core permite que você desenvolva aplicativos com o .NET Core.The .NET Core SDK allows you to develop apps with .NET Core. Se você instalar o SDK do .NET Core, não será necessário instalar o tempo de execução correspondente.If you install the .NET Core SDK, you don't need to install the corresponding runtime. Para instalar o SDK do .NET Core, execute os seguintes comandos:To install the .NET Core SDK, run the following commands:

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 .If you receive an error message similar to Unable to locate package dotnet-sdk-2.1 , see the APT troubleshooting section.

Instalar o runtimeInstall the 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.The .NET Core Runtime allows you to run apps that were made with .NET Core that didn't include the runtime. 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.The following commands install the ASP.NET Core Runtime, which is the most compatible runtime for .NET Core. Em seu terminal, execute os comandos a seguir.In your terminal, run the following commands.

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 .If you receive an error message similar to Unable to locate package aspnetcore-runtime-2.1 , see the APT troubleshooting section.

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 .As an alternative to the ASP.NET Core Runtime, you can install the .NET Core Runtime, which doesn't include ASP.NET Core support: replace aspnetcore-runtime-2.1 in the previous command with dotnet-runtime-2.1.

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

16,10 ❌16.10 ❌

❌ Observe que esta versão do Ubuntu não é mais suportada.❌ Please note that this version of Ubuntu is no longer supported.

A instalação com APT pode ser feita com alguns comandos.Installing with APT can be done with a few commands. 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.Before you install .NET, run the following commands to add the Microsoft package signing key to your list of trusted keys and add the package repository.

Abra um terminal e execute os seguintes comandos:Open a terminal and run the following commands:

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

Instalar o SDKInstall the SDK

O SDK do .NET Core permite que você desenvolva aplicativos com o .NET Core.The .NET Core SDK allows you to develop apps with .NET Core. Se você instalar o SDK do .NET Core, não será necessário instalar o tempo de execução correspondente.If you install the .NET Core SDK, you don't need to install the corresponding runtime. Para instalar o SDK do .NET Core, execute os seguintes comandos:To install the .NET Core SDK, run the following commands:

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 .If you receive an error message similar to Unable to locate package dotnet-sdk-2.1 , see the APT troubleshooting section.

Instalar o runtimeInstall the 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.The .NET Core Runtime allows you to run apps that were made with .NET Core that didn't include the runtime. 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.The following commands install the ASP.NET Core Runtime, which is the most compatible runtime for .NET Core. Em seu terminal, execute os comandos a seguir.In your terminal, run the following commands.

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 .If you receive an error message similar to Unable to locate package aspnetcore-runtime-2.1 , see the APT troubleshooting section.

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 .As an alternative to the ASP.NET Core Runtime, you can install the .NET Core Runtime, which doesn't include ASP.NET Core support: replace aspnetcore-runtime-2.1 in the previous command with dotnet-runtime-2.1.

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

16, 4 ✔️16.04 ✔️

A instalação com APT pode ser feita com alguns comandos.Installing with APT can be done with a few commands. 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.Before you install .NET, run the following commands to add the Microsoft package signing key to your list of trusted keys and add the package repository.

Abra um terminal e execute os seguintes comandos:Open a terminal and run the following commands:

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

Instalar o SDKInstall the SDK

O SDK do .NET permite que você desenvolva aplicativos com o .NET.The .NET SDK allows you to develop apps with .NET. Se você instalar o SDK do .NET, não precisará instalar o tempo de execução correspondente.If you install the .NET SDK, you don't need to install the corresponding runtime. Para instalar o SDK do .NET, execute os seguintes comandos:To install the .NET SDK, run the following commands:

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 .If you receive an error message similar to Unable to locate package dotnet-sdk-5.0 , see the APT troubleshooting section.

Instalar o runtimeInstall the 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.The ASP.NET Core Runtime allows you to run apps that were made with .NET that didn't provide the runtime. 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.The following commands install the ASP.NET Core Runtime, which is the most compatible runtime for .NET. Em seu terminal, execute os seguintes comandos:In your terminal, run the following commands:

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 .If you receive an error message similar to Unable to locate package aspnetcore-runtime-5.0 , see the APT troubleshooting section.

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 :As an alternative to the ASP.NET Core Runtime, you can install the .NET Runtime, which doesn't include ASP.NET Core support: replace aspnetcore-runtime-5.0 in the previous command with dotnet-runtime-5.0:

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

Como instalar outras versõesHow to install other versions

Os pacotes adicionados aos feeds do Gerenciador de pacotes são nomeados em um formato hackable: {product}-{type}-{version} .The packages added to package manager feeds are named in a hackable format: {product}-{type}-{version}.

  • remessaproduct
    O tipo de produto .NET a ser instalado.The type of .NET product to install. As opções válidas são:Valid options are:

    • dotnetdotnet
    • aspnetcoreaspnetcore
  • Escrevatype
    Escolhe o SDK ou o tempo de execução.Chooses the SDK or the runtime. As opções válidas são:Valid options are:

    • sdksdk
    • runtimeruntime
  • Versãoversion
    A versão do SDK ou do tempo de execução a ser instalado.The version of the SDK or runtime to install. Este artigo sempre fornecerá as instruções para a versão mais recente com suporte.This article will always give the instructions for the latest supported version. As opções válidas são qualquer versão lançada, como:Valid options are any released version, such as:

    • 5.05.0
    • 3.13.1
    • 3.03.0
    • 2.12.1

    É possível que o SDK/tempo de execução que você está tentando baixar não esteja disponível para sua distribuição do Linux.It's possible the SDK/runtime you're trying to download is not available for your Linux distribution. Para obter uma lista de distribuições com suporte, consulte dependências e requisitos do .NET Core.For a list of supported distributions, see .NET Core dependencies and requirements.

ExemplosExamples

  • Instale o tempo de execução do ASP.NET Core 5,0: aspnetcore-runtime-5.0Install the ASP.NET Core 5.0 runtime: aspnetcore-runtime-5.0
  • Instale o tempo de execução do .NET Core 2,1: dotnet-runtime-2.1Install the .NET Core 2.1 runtime: dotnet-runtime-2.1
  • Instale o SDK do .NET 5,0: dotnet-sdk-5.0Install the .NET 5.0 SDK: dotnet-sdk-5.0
  • Instale o SDK do .NET Core 3,1: dotnet-sdk-3.1Install the .NET Core 3.1 SDK: dotnet-sdk-3.1

Pacote ausentePackage missing

Se a combinação de versão do pacote não funcionar, ela não estará disponível.If the package-version combination doesn't work, it's not available. Por exemplo, não há um SDK ASP.NET Core, os componentes do SDK estão incluídos no SDK do .NET.For example, there isn't an ASP.NET Core SDK, the SDK components are included with the .NET SDK. O valor aspnetcore-sdk-2.2 está incorreto e deve ser dotnet-sdk-2.2 .The value aspnetcore-sdk-2.2 is incorrect and should be dotnet-sdk-2.2. Para obter uma lista de distribuições do Linux com suporte no .NET Core, consulte dependências e requisitos do .net.For a list of Linux distributions supported by .NET Core, see .NET dependencies and requirements.

Usar a APT para atualizar o .NETUse APT to update .NET

Quando uma nova versão de patch estiver disponível para o .NET, você poderá simplesmente atualizá-la por meio de APT com os seguintes comandos:When a new patch release is available for .NET, you can simply upgrade it through APT with the following commands:

sudo apt-get update
sudo apt-get upgrade

Solução de problemas da APTAPT troubleshooting

Esta seção fornece informações sobre erros comuns que você pode obter ao usar a APT para instalar o .NET.This section provides information on common errors you may get while using APT to install .NET.

Não é possível localizar o pacoteUnable to find package

Importante

As instalações do Gerenciador de pacotes têm suporte apenas na arquitetura x64 .Package manager installs are only supported on the x64 architecture. Outras arquiteturas, como o ARM, devem instalar o .net por outros meios, como com snap, um script de instalador ou por meio de uma instalação manual binária.Other architectures, such as ARM, must install .NET by some other means such as with Snap, an installer script, or through a manual binary installation.

Para obter mais informações sobre como instalar o .NET sem um Gerenciador de pacotes, consulte um dos seguintes artigos:For more information on installing .NET without a package manager, see one of the following articles:

Não foi possível \ instalar alguns pacotesUnable to locate \ Some packages could not be installed

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.If you receive an error message similar to Unable to locate package {dotnet-package} or Some packages could not be installed , run the following commands.

Há dois espaços reservados no seguinte conjunto de comandos.There are two placeholders in the following set of commands.

  • {dotnet-package}
    Isso representa o pacote .NET que você está instalando, como aspnetcore-runtime-3.1 .This represents the .NET package you're installing, such as aspnetcore-runtime-3.1. Isso é usado no comando a seguir sudo apt-get install .This is used in the following sudo apt-get install command.

  • {os-version}
    Isso representa a versão do Linux em que você está.This represents the Linux version you are on. Isso é usado no wget comando a seguir.This is used in the wget command below.

Primeiro, tente limpar a lista de pacotes:First, try purging the package list:

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

Em seguida, tente instalar o .NET novamente.Then, try to install .NET again. Se isso não funcionar, você poderá executar uma instalação manual com os seguintes comandos:If that doesn't work, you can run a manual install with the following commands:

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 buscarFailed to fetch

Ao instalar o pacote .NET, você poderá ver um erro semelhante a Failed to fetch ... File has unexpected size ... Mirror sync in progress? .While installing the .NET package, you may see an error similar to 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.This error could mean that the package feed for .NET is being upgraded with newer package versions, and that you should try again later. Durante uma atualização, o feed de pacote não deve ficar indisponível por mais de 30 minutos.During an upgrade, the package feed shouldn't be unavailable for more than 30 minutes. Se você receber esse erro continuamente por mais de 30 minutos, registre um problema em https://github.com/dotnet/core/issues .If you continually receive this error for more than 30 minutes, please file an issue at https://github.com/dotnet/core/issues.

DependênciasDependencies

Quando você instala o com um Gerenciador de pacotes, essas bibliotecas são instaladas para você.When you install with a package manager, these libraries are installed for you. Mas, se você instalar o .NET manualmente ou publicar um aplicativo independente, precisará verificar se essas bibliotecas estão instaladas:But, if you manually install .NET or you publish a self-contained app, you'll need to make sure these libraries are installed:

  • libc6libc6
  • libgcc1libgcc1
  • libgssapi-krb5-2libgssapi-krb5-2
  • libicu52 (para 14.x)libicu52 (for 14.x)
  • libicu55 (para 16.x)libicu55 (for 16.x)
  • libicu60 (para 18.x)libicu60 (for 18.x)
  • libicu66 (para 20. x)libicu66 (for 20.x)
  • libssl 1.0.0 (para 14. x, 16. x)libssl1.0.0 (for 14.x, 16.x)
  • libssl 1.1 (para 18. x, 20. x)libssl1.1 (for 18.x, 20.x)
  • libstdc + + 6libstdc++6
  • zlib1gzlib1g

Para aplicativos .NET que usam o assembly System. Drawing. Common , você também precisa da seguinte dependência:For .NET apps that use the System.Drawing.Common assembly, you also need the following dependency:

Próximas etapasNext steps