Instalar o .NET SDK ou .NET Runtime no Ubuntu
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
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 , libgdiplus deve ser instalado. Para obter mais informações, consulte System.Drawing.Common suportado apenas no Windows.
Você pode instalar uma versão recente do libgdiplusadicionando o repositório Mono ao seu sistema.
Ubuntu 24.04
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.04:
| Versões .NET suportadas | Available in built-in Ubuntu feed |
Disponível em backports Feed do Ubuntu |
Disponível em Feed da Microsoft |
|---|---|---|---|
| 9.0, 8.0 | 8.0 | 9.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.
O .NET está disponível no repositório de pacotes de backports do Ubuntu .NET. Para adicionar o repositório, abra um terminal e execute o seguinte comando:
sudo add-apt-repository ppa:dotnet/backports
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 , libgdiplus deve ser instalado. Para obter mais informações, consulte System.Drawing.Common suportado apenas no Windows.
Você pode instalar uma versão recente do libgdiplusadicionando 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 |
|---|---|---|---|
| 9.0, 8.0 | 8.0, 7.0, 6.0 | 9.0 | 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.
O .NET está disponível no repositório de pacotes de backports do Ubuntu .NET. Para adicionar o repositório, abra um terminal e execute o seguinte comando:
sudo add-apt-repository ppa:dotnet/backports
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
- 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 , libgdiplus deve ser instalado. Para obter mais informações, consulte System.Drawing.Common suportado apenas no Windows.
Você pode instalar uma versão recente do libgdiplusadicionando 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 | 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
Como o Ubuntu 20.04 chega ao fim da vida útil em abril de 2025, a Microsoft decidiu não suportar o .NET 9 no Ubuntu 20.04.
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 , libgdiplus deve ser instalado. Para obter mais informações, consulte System.Drawing.Common suportado apenas no Windows.
Você pode instalar uma versão recente do libgdiplusadicionando 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
- .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:dotnetaspnetcore
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:9.08.03.12.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 9.0:
aspnetcore-runtime-9.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.
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 , libgdiplus deve ser instalado. Para obter mais informações, consulte System.Drawing.Common suportado apenas no Windows.
Você pode instalar uma versão recente do libgdiplusadicionando 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.
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 , libgdiplus deve ser instalado. Para obter mais informações, consulte System.Drawing.Common suportado apenas no Windows.
Você pode instalar uma versão recente do libgdiplusadicionando 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.
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 , libgdiplus deve ser instalado. Para obter mais informações, consulte System.Drawing.Common suportado apenas no Windows.
Você pode instalar uma versão recente do libgdiplusadicionando o repositório Mono ao seu sistema.
