Instalación del SDK o el runtime de .NET en Ubuntu
En este artículo se describe cómo instalar .NET en Ubuntu.
Instale el SDK (que incluye el entorno de ejecución) si quiere desarrollar aplicaciones .NET. O bien, si solo necesita ejecutar aplicaciones, instale el entorno de ejecución. Si va a instalar el entorno de ejecución, se recomienda instalar el entorno de ejecución de ASP.NET Core, ya que incluye los de .NET y ASP.NET Core.
Use los comandos dotnet --list-sdks y dotnet --list-runtimes para ver qué versiones están instaladas. Para obtener más información, vea Cómo comprobar que .NET Core ya está instalado.
Importante
El uso de un administrador de paquetes para instalar .NET desde la fuente de paquetes de Microsoft solo admite la arquitectura x64. Otras arquitecturas, como la Arm, no son compatibles con la Fuente de paquetes de Microsoft. Use las fuentes de Ubuntu o instale manualmente .NET. Tenga cuidado con los problemas de combinación de paquetes al usar varias fuentes. Para más información, consulte Mezclas de paquetes .NET en Linux.
Para obtener más información sobre cómo instalar .NET sin un administrador de paquetes, consulte uno de los siguientes artículos:
Ubuntu 24.10
.NET está disponible en las fuentes del administrador de paquetes de Ubuntu. El repositorio de paquetes de Microsoft ya no contiene paquetes .NET para Ubuntu.
Las siguientes versiones de .NET son compatibles o están disponibles para Ubuntu 24.10:
- 9.0
- 8.0
Cuando una versión de Ubuntu no es compatible, .NET deja de ser compatible con esa versión.
Importante
.NET 9 se publicó el 12 de noviembre de 2024. Los paquetes pueden tardar tiempo en aparecer en las fuentes del administrador de paquetes o en la distribución específica de Linux para incluirlos.
Instalación del SDK
El SDK de .NET permite desarrollar aplicaciones con .NET. Si instala el SDK de .NET, no necesita instalar el entorno de ejecución correspondiente. Para instalar el SDK de .NET, ejecute los comandos siguientes:
sudo apt-get update && \
sudo apt-get install -y dotnet-sdk-9.0
Para obtener información sobre cómo usar la CLI de .NET, consulte Información general sobre la CLI de .NET.
Instalación de la instancia en tiempo de ejecución
El entorno de ejecución de ASP.NET Core le permite ejecutar aplicaciones creadas con .NET en las que no se ha proporcionado el entorno de ejecución. Los comandos siguientes instalan el entorno de ejecución de ASP.NET Core, el más compatible con .NET. En el terminal, ejecute los comandos siguientes:
sudo apt-get update && \
sudo apt-get install -y aspnetcore-runtime-9.0
Una alternativa al entorno de ejecución de ASP.NET Core es instalar el de .NET, que no incluye compatibilidad con ASP.NET Core; en el comando anterior, reemplace aspnetcore-runtime-9.0 por dotnet-runtime-9.0:
sudo apt-get install -y dotnet-runtime-9.0
Para obtener información sobre cómo usar la CLI de .NET, consulte Información general sobre la CLI de .NET.
Dependencias
Al realizar la instalación con un administrador de paquetes, estas bibliotecas se instalan automáticamente. Pero si instala manualmente .NET o publica una aplicación independiente, deberá asegurarse de que estas bibliotecas estén instaladas:
- ca-certificates
- libc6
- libgcc-s1
- libicu74
- liblttng-ust1
- libssl3
- libstdc++6
- libunwind8
- zlib1g
Las dependencias se pueden instalar con el comando apt install. En el fragmento de código siguiente se muestra cómo instalar la biblioteca zlib1g:
sudo apt install zlib1g
Si la aplicación .NET usa el ensamblado System.Drawing.Common , debe instalarse libgdiplus . Para obtener más información, consulte System.Drawing.Common only supported on Windows (Solo se admite System.Drawing.Common en Windows).
Puede instalar una versión reciente de libgdiplusagregando el repositorio Mono al sistema.
Ubuntu 24.04
.NET está disponible en las fuentes del administrador de paquetes de Ubuntu, así como en el repositorio de paquetes de Microsoft. Sin embargo, para instalar .NET solo debe usar una de estas opciones. Microsoft recomienda usar las fuentes del administrador de paquetes de Ubuntu. Si quiere usar el repositorio de paquetes de Microsoft, vea Procedimientos para registrar el repositorio de paquetes de Microsoft.
Las versiones siguientes de .NET son compatibles o están disponibles para Ubuntu 24.04:
| Versiones de .NET compatibles | Disponible en fuente integrada de Ubuntu |
Disponible en backports Fuente de Ubuntu |
Disponible en La fuente de Microsoft |
|---|---|---|---|
| 9.0, 8.0 | 8.0 | 9.0, 7.0, 6.0 | Ninguno |
Cuando una versión de Ubuntu no es compatible, .NET deja de ser compatible con esa versión.
.NET está disponible en el repositorio de paquetes backports de Ubuntu .NET. Para agregar el repositorio, abra un terminal y ejecute el siguiente comando:
sudo add-apt-repository ppa:dotnet/backports
Instalación del SDK
El SDK de .NET permite desarrollar aplicaciones con .NET. Si instala el SDK de .NET, no necesita instalar el entorno de ejecución correspondiente. Para instalar el SDK de .NET, ejecute los comandos siguientes:
sudo apt-get update && \
sudo apt-get install -y dotnet-sdk-9.0
Para obtener información sobre cómo usar la CLI de .NET, consulte Información general sobre la CLI de .NET.
Instalación de la instancia en tiempo de ejecución
El entorno de ejecución de ASP.NET Core le permite ejecutar aplicaciones creadas con .NET en las que no se ha proporcionado el entorno de ejecución. Los comandos siguientes instalan el entorno de ejecución de ASP.NET Core, el más compatible con .NET. En el terminal, ejecute los comandos siguientes:
sudo apt-get update && \
sudo apt-get install -y aspnetcore-runtime-9.0
Una alternativa al entorno de ejecución de ASP.NET Core es instalar el de .NET, que no incluye compatibilidad con ASP.NET Core; en el comando anterior, reemplace aspnetcore-runtime-9.0 por dotnet-runtime-9.0:
sudo apt-get install -y dotnet-runtime-9.0
Para obtener información sobre cómo usar la CLI de .NET, consulte Información general sobre la CLI de .NET.
Dependencias
Al realizar la instalación con un administrador de paquetes, estas bibliotecas se instalan automáticamente. Pero si instala manualmente .NET o publica una aplicación independiente, deberá asegurarse de que estas bibliotecas estén instaladas:
- ca-certificates
- libc6
- libgcc-s1
- libicu74
- liblttng-ust1
- libssl3
- libstdc++6
- libunwind8
- zlib1g
Las dependencias se pueden instalar con el comando apt install. En el fragmento de código siguiente se muestra cómo instalar la biblioteca zlib1g:
sudo apt install zlib1g
Si la aplicación .NET usa el ensamblado System.Drawing.Common , debe instalarse libgdiplus . Para obtener más información, consulte System.Drawing.Common only supported on Windows (Solo se admite System.Drawing.Common en Windows).
Puede instalar una versión reciente de libgdiplusagregando el repositorio Mono al sistema.
Ubuntu 22.04
.NET está disponible en las fuentes del administrador de paquetes de Ubuntu, así como en el repositorio de paquetes de Microsoft. Sin embargo, para instalar .NET solo debe usar una de estas opciones. Microsoft recomienda usar las fuentes del administrador de paquetes de Ubuntu. Si quiere usar el repositorio de paquetes de Microsoft, vea Procedimientos para registrar el repositorio de paquetes de Microsoft.
Las versiones siguientes de .NET son compatibles o están disponibles para Ubuntu 22.04:
| Versiones de .NET compatibles | Disponible en fuente integrada de Ubuntu |
Disponible en Paquetes anteriores de .NET Fuente de Ubuntu |
Disponible en La fuente de Microsoft |
|---|---|---|---|
| 9.0, 8.0 | 8.0, 7.0, 6.0 | 9.0 | 8.0, 7.0, 6.0, 3.1 |
Importante
Si usa el SDK de .NET 8 y Ubuntu 22.04, comprenda que las versiones del SDK que ofrece Canonical siempre están en la banda de características .1xx. Si quiere usar una versión de banda de características más reciente, utilice la fuente de Microsoft para instalar el SDK. Asegúrese de revisar la información del artículo Combinaciones de paquetes de .NET en Linux para comprender las implicaciones de cambiar entre fuentes de repositorio.
Cuando una versión de Ubuntu no es compatible, .NET deja de ser compatible con esa versión.
.NET está disponible en el repositorio de paquetes backports de Ubuntu .NET. Para agregar el repositorio, abra un terminal y ejecute el siguiente comando:
sudo add-apt-repository ppa:dotnet/backports
Instalación del SDK
El SDK de .NET permite desarrollar aplicaciones con .NET. Si instala el SDK de .NET, no necesita instalar el entorno de ejecución correspondiente. Para instalar el SDK de .NET, ejecute los comandos siguientes:
sudo apt-get update && \
sudo apt-get install -y dotnet-sdk-9.0
Para obtener información sobre cómo usar la CLI de .NET, consulte Información general sobre la CLI de .NET.
Instalación de la instancia en tiempo de ejecución
El entorno de ejecución de ASP.NET Core le permite ejecutar aplicaciones creadas con .NET en las que no se ha proporcionado el entorno de ejecución. Los comandos siguientes instalan el entorno de ejecución de ASP.NET Core, el más compatible con .NET. En el terminal, ejecute los comandos siguientes:
sudo apt-get update && \
sudo apt-get install -y aspnetcore-runtime-9.0
Una alternativa al entorno de ejecución de ASP.NET Core es instalar el de .NET, que no incluye compatibilidad con ASP.NET Core; en el comando anterior, reemplace aspnetcore-runtime-9.0 por dotnet-runtime-9.0:
sudo apt-get install -y dotnet-runtime-9.0
Para obtener información sobre cómo usar la CLI de .NET, consulte Información general sobre la CLI de .NET.
Dependencias
Al realizar la instalación con un administrador de paquetes, estas bibliotecas se instalan automáticamente. Pero si instala manualmente .NET o publica una aplicación independiente, deberá asegurarse de que estas bibliotecas estén instaladas:
- ca-certificates
- libc6
- libgcc-s1
- libgssapi-krb5-2
- libicu70
- liblttng-ust1
- libssl3
- libstdc++6
- libunwind8
- zlib1g
Las dependencias se pueden instalar con el comando apt install. En el fragmento de código siguiente se muestra cómo instalar la biblioteca zlib1g:
sudo apt install zlib1g
Si la aplicación .NET usa el ensamblado System.Drawing.Common , debe instalarse libgdiplus . Para obtener más información, consulte System.Drawing.Common only supported on Windows (Solo se admite System.Drawing.Common en Windows).
Puede instalar una versión reciente de libgdiplusagregando el repositorio Mono al sistema.
Ubuntu 20.04
El repositorio de paquetes de Ubuntu predeterminado no contiene esta versión de .NET. En su lugar, use el repositorio de paquetes de Microsoft.
Las versiones siguientes de .NET son compatibles o están disponibles para Ubuntu 20.04:
| Versiones de .NET compatibles | Disponible en fuente integrada de Ubuntu |
Disponible en Paquetes anteriores de .NET Fuente de Ubuntu |
Disponible en La fuente de Microsoft |
|---|---|---|---|
| 8.0 | Ninguno | None | 8.0, 7.0. 6.0, 5.0, 3.1, 2.1 |
Cuando una versión de Ubuntu no es compatible, .NET deja de ser compatible con esa versión.
Incorporación del repositorio de paquetes de Microsoft
La instalación con APT puede realizarse con unos pocos comandos. Antes de instalar .NET, ejecute los siguientes comandos para agregar la clave de la firma del paquete de Microsoft a la lista de claves de confianza y agregar el repositorio de paquetes.
Abra un terminal y ejecute los comandos siguientes:
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
Dado que Ubuntu 20.04 alcanza el final de la vida en abril de 2025, Microsoft ha decidido no admitir .NET 9 en Ubuntu 20.04.
Dependencias
Al realizar la instalación con un administrador de paquetes, estas bibliotecas se instalan automáticamente. Pero si instala manualmente .NET o publica una aplicación independiente, deberá asegurarse de que estas bibliotecas estén instaladas:
- ca-certificates
- libc6
- libgcc-s1
- libgssapi-krb5-2
- libicu66
- libssl1.1
- libstdc++6
- zlib1g
Las dependencias se pueden instalar con el comando apt install. En el fragmento de código siguiente se muestra cómo instalar la biblioteca zlib1g:
sudo apt install zlib1g
Si la aplicación .NET usa el ensamblado System.Drawing.Common , debe instalarse libgdiplus . Para obtener más información, consulte System.Drawing.Common only supported on Windows (Solo se admite System.Drawing.Common en Windows).
Puede instalar una versión reciente de libgdiplusagregando el repositorio Mono al sistema.
Versiones no admitidas
Las versiones siguientes de .NET ya ❌ no se admiten:
- .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
Procedimiento para instalar otras versiones
Los nombres de paquetes .NET están estandarizados en todas las distribuciones de Linux. En la siguiente tabla se muestra una lista de los paquetes:
Todas las versiones de .NET están disponibles para la descarga en https://dotnet.microsoft.com/download/dotnet, pero requieren la instalación manual. Puede intentar usar el administrador de paquetes para instalar una versión diferente de .NET. Sin embargo, es posible que la versión solicitada no esté disponible.
Los paquetes agregados a las fuentes del administrador de paquetes se denominan con un formato susceptible de intrusiones, como, por ejemplo: {product}-{type}-{version}.
product
Tipo de producto .NET que se va a instalar. Las opciones válidas son:dotnetaspnetcore
type
Elige el SDK o el entorno de ejecución. Las opciones válidas son:sdk(solo disponible para el producto dotnet)runtime
version
Versión del SDK o del entorno de ejecución que se va a instalar. Las opciones válidas son cualquier versión de lanzamiento, como las siguientes:9.08.03.12.1
Es posible que el SDK o el entorno de ejecución que intenta descargar no esté disponible para la distribución de Linux. Para obtener una lista de las distribuciones admitidas, vea Instalación de .NET en Linux.
Ejemplos
- Instale el entorno de ejecución de ASP.NET Core 9.0:
aspnetcore-runtime-9.0 - Instalación del entorno de ejecución de ASP.NET Core 2.1:
dotnet-runtime-2.1 - Instalación del SDK de .NET 5:
dotnet-sdk-5.0 - Instalación del SDK de .NET Core 3.1:
dotnet-sdk-3.1
Nota:
Es posible que algún paquete no esté disponible en la distribución de Linux.
Falta el paquete
Si la combinación de paquete y versión no funciona, no está disponible. Por ejemplo, no hay un SDK de ASP.NET Core. Los componentes del SDK para ASP.NET Core se incluyen con el SDK de .NET. El valor aspnetcore-sdk-8.0 es no es correcto y debe ser dotnet-sdk-8.0. Para obtener una lista de las distribuciones de Linux compatibles con .NET, vea Dependencias y requisitos de .NET.
Instalación manual
Si no se admite la versión de Ubuntu, lo más probable es que tenga que instalar .NET mediante la extracción manual de los archivos binarios mediante el script de instalación. Para obtener más información, consulte Instalación de .NET en Linux sin usar un administrador de paquetes.
Ubuntu 23.10
Advertencia
Esta versión de Ubuntu ya no se admite.
Ya no se admite la ejecución de .NET en esta versión de Ubuntu.
.NET está disponible en las fuentes del administrador de paquetes de Ubuntu, así como en el repositorio de paquetes de Microsoft. Sin embargo, para instalar .NET solo debe usar una de estas opciones. Microsoft recomienda usar las fuentes del administrador de paquetes de Ubuntu. Si quiere usar el repositorio de paquetes de Microsoft, vea Procedimientos para registrar el repositorio de paquetes de Microsoft.
Se admiten o están disponibles las siguientes versiones de .NET para Ubuntu 23.10:
| Versiones de .NET compatibles | Disponible en fuente integrada de Ubuntu |
Disponible en Paquetes anteriores de .NET Fuente de Ubuntu |
Disponible en La fuente de Microsoft |
|---|---|---|---|
| 8.0, 6.0 | 8.0, 7.0, 6.0 | None | 8.0, 7.0, 6.0 |
Importante
Si usa el SDK de .NET 8 y Ubuntu 22.04, comprenda que las versiones del SDK que ofrece Canonical siempre están en la banda de características .1xx. Si quiere usar una versión de banda de características más reciente, utilice la fuente de Microsoft para instalar el SDK. Asegúrese de revisar la información del artículo Combinaciones de paquetes de .NET en Linux para comprender las implicaciones de cambiar entre fuentes de repositorio.
Cuando una versión de Ubuntu no es compatible, .NET deja de ser compatible con esa versión.
Dependencias
Al realizar la instalación con un administrador de paquetes, estas bibliotecas se instalan automáticamente. Pero si instala manualmente .NET o publica una aplicación independiente, deberá asegurarse de que estas bibliotecas estén instaladas:
- ca-certificates
- libc6
- libgcc-s1
- libgssapi-krb5-2
- libicu72
- liblttng-ust1
- libssl3
- libstdc++6
- libunwind8
- zlib1g
Las dependencias se pueden instalar con el comando apt install. En el fragmento de código siguiente se muestra cómo instalar la biblioteca zlib1g:
sudo apt install zlib1g
Si la aplicación .NET usa el ensamblado System.Drawing.Common , debe instalarse libgdiplus . Para obtener más información, consulte System.Drawing.Common only supported on Windows (Solo se admite System.Drawing.Common en Windows).
Puede instalar una versión reciente de libgdiplusagregando el repositorio Mono al sistema.
Ubuntu 23.04
Advertencia
Esta versión de Ubuntu ya no se admite.
Ya no se admite la ejecución de .NET en esta versión de Ubuntu.
.NET está disponible en las fuentes del administrador de paquetes de Ubuntu, así como en el repositorio de paquetes de Microsoft. Sin embargo, para instalar .NET solo debe usar una de estas opciones. Microsoft recomienda usar las fuentes del administrador de paquetes de Ubuntu. Si quiere usar el repositorio de paquetes de Microsoft, vea Procedimientos para registrar el repositorio de paquetes de Microsoft.
Se admiten o están disponibles las siguientes versiones de .NET para Ubuntu 23.04:
| Versiones de .NET compatibles | Disponible en fuente integrada de Ubuntu |
Disponible en Paquetes anteriores de .NET Fuente de Ubuntu |
Disponible en La fuente de Microsoft |
|---|---|---|---|
| 8.0, 6.0 | 7.0, 6.0 | None | 8.0, 7.0, 6.0 |
Importante
Si usa el SDK de .NET 8 y Ubuntu 22.04, comprenda que las versiones del SDK que ofrece Canonical siempre están en la banda de características .1xx. Si quiere usar una versión de banda de características más reciente, utilice la fuente de Microsoft para instalar el SDK. Asegúrese de revisar la información del artículo Combinaciones de paquetes de .NET en Linux para comprender las implicaciones de cambiar entre fuentes de repositorio.
Dependencias
Al realizar la instalación con un administrador de paquetes, estas bibliotecas se instalan automáticamente. Pero si instala manualmente .NET o publica una aplicación independiente, deberá asegurarse de que estas bibliotecas estén instaladas:
- ca-certificates
- libc6
- libgcc-s1
- libgssapi-krb5-2
- libicu72
- liblttng-ust1
- libssl3
- libstdc++6
- libunwind8
- zlib1g
Las dependencias se pueden instalar con el comando apt install. En el fragmento de código siguiente se muestra cómo instalar la biblioteca zlib1g:
sudo apt install zlib1g
Si la aplicación .NET usa el ensamblado System.Drawing.Common , debe instalarse libgdiplus . Para obtener más información, consulte System.Drawing.Common only supported on Windows (Solo se admite System.Drawing.Common en Windows).
Puede instalar una versión reciente de libgdiplusagregando el repositorio Mono al sistema.
Ubuntu 22.10
Advertencia
Esta versión de Ubuntu ya no se admite.
Ya no se admite la ejecución de .NET en esta versión de Ubuntu.
.NET está disponible en las fuentes del administrador de paquetes de Ubuntu, así como en el repositorio de paquetes de Microsoft. Sin embargo, para instalar .NET solo debe usar una de estas opciones. Microsoft recomienda usar las fuentes del administrador de paquetes de Ubuntu. Si quiere usar el repositorio de paquetes de Microsoft, vea Procedimientos para registrar el repositorio de paquetes de Microsoft.
Las versiones siguientes de .NET son compatibles o están disponibles para Ubuntu 22.10:
| Versiones de .NET compatibles | Disponible en fuente integrada de Ubuntu |
Disponible en Paquetes anteriores de .NET Fuente de Ubuntu |
Disponible en La fuente de Microsoft |
|---|---|---|---|
| 6.0 | 7.0, 6.0 | None | 7.0, 6.0, 3.1 |
Importante
Si usa el SDK de .NET 8 y Ubuntu 22.04, comprenda que las versiones del SDK que ofrece Canonical siempre están en la banda de características .1xx. Si quiere usar una versión de banda de características más reciente, utilice la fuente de Microsoft para instalar el SDK. Asegúrese de revisar la información del artículo Combinaciones de paquetes de .NET en Linux para comprender las implicaciones de cambiar entre fuentes de repositorio.
Dependencias
Al realizar la instalación con un administrador de paquetes, estas bibliotecas se instalan automáticamente. Pero si instala manualmente .NET o publica una aplicación independiente, deberá asegurarse de que estas bibliotecas estén instaladas:
- ca-certificates
- libc6
- libgcc-s1
- libgssapi-krb5-2
- libicu71
- liblttng-ust1
- libssl3
- libstdc++6
- libunwind8
- zlib1g
Las dependencias se pueden instalar con el comando apt install. En el fragmento de código siguiente se muestra cómo instalar la biblioteca zlib1g:
sudo apt install zlib1g
Si la aplicación .NET usa el ensamblado System.Drawing.Common , debe instalarse libgdiplus . Para obtener más información, consulte System.Drawing.Common only supported on Windows (Solo se admite System.Drawing.Common en Windows).
Puede instalar una versión reciente de libgdiplusagregando el repositorio Mono al sistema.
