Instalación del SDK de .NET Core o de .NET Core Runtime en UbuntuInstall .NET Core SDK or .NET Core Runtime on Ubuntu

.NET Core es compatible con Ubuntu..NET Core is supported on Ubuntu. En este artículo se describe cómo instalar .NET Core en Ubuntu.This article describes how to install .NET Core on Ubuntu. Cuando una versión de Ubuntu no es compatible, .NET Core deja de ser compatible con esa versión.When an Ubuntu version falls out of support, .NET Core is no longer supported with that version. Sin embargo, estas instrucciones pueden ayudarle a conseguir que .NET Core se ejecute en esas versiones, aunque no se admita.However, these instructions may help you to get .NET Core running on those versions, even though it isn't supported.

Instale el SDK (que incluye el entorno de ejecución) si quiere desarrollar aplicaciones .NET.Install the SDK (which includes the runtime) if you want to develop .NET apps. O bien, si solo necesita ejecutar aplicaciones, instale el entorno de ejecución.Or, if you only need to run apps, install the runtime. Si va a instalar el entorno de ejecución, le recomendamos que instale el entorno de ejecución de ASP.NET Core, ya que incluye los de .NET Core y ASP.NET Core.If you're installing the runtime, we suggest you install the ASP.NET Core runtime as it includes both .NET Core and ASP.NET Core runtimes.

Si ya ha instalado el SDK o el entorno de ejecución, use los comandos dotnet --list-sdks y dotnet --list-runtimes para ver qué versiones están 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 más información, consulte Cómo comprobar que .NET Core ya está instalado.For more information, see How to check that .NET Core is already installed.

Las instalaciones del administrador de paquetes solo se admiten en la arquitectura x64.Package manager installs are only supported on the x64 architecture. Otras arquitecturas, como ARM, deben instalar manualmente el SDK de .NET Core o .NET Core Runtime.Other architectures, such as ARM, must manually install the .NET Core SDK or .NET Core Runtime. Para obtener más información, vea la sección Instalación manual.For more information, see the manually install section.

Distribuciones admitidasSupported distributions

En la tabla siguiente se muestra una lista de versiones de .NET Core actualmente compatibles y las versiones de Ubuntu en las que se admiten.The following table is a list of currently supported .NET Core releases and the versions of Ubuntu they're supported on. Estas versiones siguen siendo compatibles hasta que la versión de .NET Core llegue al fin del soporte técnico o la versión de Ubuntu llegue al final del ciclo de vida.These versions remain supported until either the version of .NET Core reaches end-of-support or the version of Ubuntu reaches end-of-life.

  • Una ✔️ indica que todavía se admite la versión de Ubuntu o de .NET Core.A ✔️ indicates that the version of Ubuntu or .NET Core is still supported.
  • Una ❌ indica que la versión de Ubuntu o de .NET Core no se admite en esa versión de Ubuntu.A ❌ indicates that the version of Ubuntu or .NET Core isn't supported on that Ubuntu release.
  • Cuando una versión de Ubuntu y una versión de .NET Core tienen una ✔️, se admite esa combinación de sistema operativo y .NET.When both a version of Ubuntu and a version of .NET Core have ✔️, that OS and .NET combination are supported.
UbuntuUbuntu .NET Core 2.1.NET Core 2.1 .NET Core 3.1.NET Core 3.1 Versión preliminar de .NET 5 (solo instalación manual).NET 5 Preview (manual install only)
✔️ 20.04 (LTS)✔️ 20.04 (LTS) ✔️ 2.1✔️ 2.1 ✔️ 3.1✔️ 3.1 ✔️ 5.0 (versión preliminar)✔️ 5.0 Preview
❌ 19.1019.10 ✔️ 2.1✔️ 2.1 ✔️ 3.1✔️ 3.1 ✔️ 5.0 (versión preliminar)✔️ 5.0 Preview
19.0419.04 ✔️ 2.1✔️ 2.1 ✔️ 3.1✔️ 3.1 ❌ 5.0 (versión preliminar)❌ 5.0 Preview
18.1018.10 ✔️ 2.1✔️ 2.1 ❌ 3.1❌ 3.1 ❌ 5.0 (versión preliminar)❌ 5.0 Preview
✔️ 18.04 (LTS)✔️ 18.04 (LTS) ✔️ 2.1✔️ 2.1 ✔️ 3.1✔️ 3.1 ✔️ 5.0 (versión preliminar)✔️ 5.0 Preview
17.1017.10 ✔️ 2.1✔️ 2.1 ❌ 3.1❌ 3.1 ❌ 5.0 (versión preliminar)❌ 5.0 Preview
17.0417.04 ✔️ 2.1✔️ 2.1 ❌ 3.1❌ 3.1 ❌ 5.0 (versión preliminar)❌ 5.0 Preview
16.1016.10 ❌ 2.1❌ 2.1 ❌ 3.1❌ 3.1 ❌ 5.0 (versión preliminar)❌ 5.0 Preview
✔️ 16.04 (LTS)✔️ 16.04 (LTS) ✔️ 2.1✔️ 2.1 ✔️ 3.1✔️ 3.1 ✔️ 5.0 (versión preliminar)✔️ 5.0 Preview

Las siguientes versiones de .NET Core ya no se admiten.The following versions of .NET Core are no longer supported. aunque sus descargas siguen estando publicadas:The downloads for these still remain published:

  • 3.03.0
  • 2.22.2
  • 2.02.0

Procedimiento para instalar otras versionesHow to install other versions

Los paquetes agregados a las fuentes del administrador de paquetes se denominan con un formato susceptible de intrusiones: {product}-{type}-{version}.The packages added to package manager feeds are named in a hackable format: {product}-{type}-{version}.

  • productproduct
    Tipo de producto .NET que se va a instalar.The type of .NET product to install. Las opciones válidas son:Valid options are:

    • dotnetdotnet
    • aspnetcoreaspnetcore
  • typetype
    Elige el SDK o el entorno de ejecución.Chooses the SDK or the runtime. Las opciones válidas son:Valid options are:

    • sdksdk
    • motor en tiempo de ejecuciónruntime
  • versionversion
    Versión del SDK o del entorno de ejecución que se va a instalar.The version of the SDK or runtime to install. En este artículo se proporcionarán siempre las instrucciones para la última versión admitida.This article will always give the instructions for the latest supported version. Las opciones válidas son cualquier versión de lanzamiento, como las siguientes:Valid options are any released version, such as:

    • 3.13.1
    • 3.03.0
    • 2.12.1

    Es posible que el SDK o el entorno de ejecución que intenta descargar no esté disponible para su distribución de Linux.It's possible the SDK/runtime you're trying to download is not available for your Linux distribution. Para obtener una lista de las distribuciones admitidas, consulte Dependencias y requisitos de .NET Core.For a list of supported distributions, see .NET Core dependencies and requirements.

EjemplosExamples

  • Instalación del runtime de ASP.NET Core 3.1: aspnetcore-runtime-3.1Install the ASP.NET Core 3.1 runtime: aspnetcore-runtime-3.1
  • Instalación del entorno de ejecución de ASP.NET Core 2.1: dotnet-runtime-2.1Install the .NET Core 2.1 runtime: dotnet-runtime-2.1
  • Instalación del SDK de .NET Core 3.1: dotnet-sdk-3.1Install the .NET Core 3.1 SDK: dotnet-sdk-3.1

Falta el paquetePackage missing

Si la combinación de paquete y versión no funciona, no está disponible.If the package-version combination doesn't work, it's not available. Por ejemplo, no hay un SDK de ASP.NET Core; los componentes del SDK se incluyen en el SDK de .NET Core.For example, there isn't an ASP.NET Core SDK, the SDK components are included with the .NET Core SDK. El valor aspnetcore-sdk-2.2 es no es correcto y debe ser dotnet-sdk-2.2.The value aspnetcore-sdk-2.2 is incorrect and should be dotnet-sdk-2.2. Para obtener una lista de las distribuciones de Linux compatibles con .NET Core, consulte Dependencias y requisitos de .NET Core.For a list of Linux distributions supported by .NET Core, see .NET Core dependencies and requirements.

20.04 ✔️20.04 ✔️

La instalación con APT puede realizarse con unos pocos comandos.Installing with APT can be done with a few commands. 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.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 un terminal y ejecute los comandos siguientes: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

Instalación del SDKInstall the SDK

El SDK de .NET Core permite desarrollar aplicaciones con .NET Core..NET Core SDK allows you to develop apps with .NET Core. Si instala el SDK de .NET Core, no necesita instalar el entorno de ejecución correspondiente.If you install .NET Core SDK, you don't need to install the corresponding runtime. Para instalar el SDK de .NET Core, ejecute los siguientes comandos:To install .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

Si recibe un mensaje de error similar a No se puede encontrar el paquete dotnet-sdk-3.1, consulte la sección Solución de problemas de APT.If you receive an error message similar to Unable to locate package dotnet-sdk-3.1, see the APT troubleshooting section.

Instalación de la instancia en tiempo de ejecuciónInstall the runtime

.NET Core Runtime le permite ejecutar aplicaciones que se realizaron con .NET Core que no incluían el entorno de ejecución.The .NET Core Runtime allows you to run apps that were made with .NET Core that didn't include the runtime. Los siguientes comandos instalan el entorno de ejecución de ASP.NET Core, que es el entorno de ejecución más compatible con .NET Core.The commands below install the ASP.NET Core Runtime, which is the most compatible runtime for .NET Core. En el terminal, ejecute los comandos siguientes.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

Si recibe un mensaje de error similar a No se puede encontrar el paquete aspnetcore-runtime-3.1, consulte la sección Solución de problemas de APT.If you receive an error message similar to Unable to locate package aspnetcore-runtime-3.1, see the APT troubleshooting section.

Una alternativa al entorno de ejecución de ASP.NET Core es instalar la instancia de .NET Core Runtime que no incluye compatibilidad con ASP.NET Core. Reemplace aspnetcore-runtime-3.1 en los comandos anteriores por dotnet-runtime-3.1.As an alternative to the ASP.NET Core Runtime, you can install the .NET Core Runtime that doesn't include ASP.NET Core support: replace aspnetcore-runtime-3.1 in the command above with dotnet-runtime-3.1.

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

19.10 ❌19.10 ❌

❌ Tenga en cuenta que ya no se admite esta versión de Ubuntu.❌ Please note that this version of Ubuntu is no longer supported.

La instalación con APT puede realizarse con unos pocos comandos.Installing with APT can be done with a few commands. 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.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 un terminal y ejecute los comandos siguientes: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

Instalación del SDKInstall the SDK

El SDK de .NET Core permite desarrollar aplicaciones con .NET Core..NET Core SDK allows you to develop apps with .NET Core. Si instala el SDK de .NET Core, no necesita instalar el entorno de ejecución correspondiente.If you install .NET Core SDK, you don't need to install the corresponding runtime. Para instalar el SDK de .NET Core, ejecute los siguientes comandos:To install .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

Si recibe un mensaje de error similar a No se puede encontrar el paquete dotnet-sdk-3.1, consulte la sección Solución de problemas de APT.If you receive an error message similar to Unable to locate package dotnet-sdk-3.1, see the APT troubleshooting section.

Instalación de la instancia en tiempo de ejecuciónInstall the runtime

.NET Core Runtime le permite ejecutar aplicaciones que se realizaron con .NET Core que no incluían el entorno de ejecución.The .NET Core Runtime allows you to run apps that were made with .NET Core that didn't include the runtime. Los siguientes comandos instalan el entorno de ejecución de ASP.NET Core, que es el entorno de ejecución más compatible con .NET Core.The commands below install the ASP.NET Core Runtime, which is the most compatible runtime for .NET Core. En el terminal, ejecute los comandos siguientes.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

Si recibe un mensaje de error similar a No se puede encontrar el paquete aspnetcore-runtime-3.1, consulte la sección Solución de problemas de APT.If you receive an error message similar to Unable to locate package aspnetcore-runtime-3.1, see the APT troubleshooting section.

Una alternativa al entorno de ejecución de ASP.NET Core es instalar la instancia de .NET Core Runtime que no incluye compatibilidad con ASP.NET Core. Reemplace aspnetcore-runtime-3.1 en los comandos anteriores por dotnet-runtime-3.1.As an alternative to the ASP.NET Core Runtime, you can install the .NET Core Runtime that doesn't include ASP.NET Core support: replace aspnetcore-runtime-3.1 in the command above with dotnet-runtime-3.1.

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

19.04 ❌19.04 ❌

❌ Tenga en cuenta que ya no se admite esta versión de Ubuntu.❌ Please note that this version of Ubuntu is no longer supported.

La instalación con APT puede realizarse con unos pocos comandos.Installing with APT can be done with a few commands. 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.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 un terminal y ejecute los comandos siguientes: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

Instalación del SDKInstall the SDK

El SDK de .NET Core permite desarrollar aplicaciones con .NET Core..NET Core SDK allows you to develop apps with .NET Core. Si instala el SDK de .NET Core, no necesita instalar el entorno de ejecución correspondiente.If you install .NET Core SDK, you don't need to install the corresponding runtime. Para instalar el SDK de .NET Core, ejecute los siguientes comandos:To install .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

Si recibe un mensaje de error similar a No se puede encontrar el paquete dotnet-sdk-3.1, consulte la sección Solución de problemas de APT.If you receive an error message similar to Unable to locate package dotnet-sdk-3.1, see the APT troubleshooting section.

Instalación de la instancia en tiempo de ejecuciónInstall the runtime

.NET Core Runtime le permite ejecutar aplicaciones que se realizaron con .NET Core que no incluían el entorno de ejecución.The .NET Core Runtime allows you to run apps that were made with .NET Core that didn't include the runtime. Los siguientes comandos instalan el entorno de ejecución de ASP.NET Core, que es el entorno de ejecución más compatible con .NET Core.The commands below install the ASP.NET Core Runtime, which is the most compatible runtime for .NET Core. En el terminal, ejecute los comandos siguientes.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

Si recibe un mensaje de error similar a No se puede encontrar el paquete aspnetcore-runtime-3.1, consulte la sección Solución de problemas de APT.If you receive an error message similar to Unable to locate package aspnetcore-runtime-3.1, see the APT troubleshooting section.

Una alternativa al entorno de ejecución de ASP.NET Core es instalar la instancia de .NET Core Runtime que no incluye compatibilidad con ASP.NET Core. Reemplace aspnetcore-runtime-3.1 en los comandos anteriores por dotnet-runtime-3.1.As an alternative to the ASP.NET Core Runtime, you can install the .NET Core Runtime that doesn't include ASP.NET Core support: replace aspnetcore-runtime-3.1 in the command above with dotnet-runtime-3.1.

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

18.10 ❌18.10 ❌

❌ Tenga en cuenta que ya no se admite esta versión de Ubuntu.❌ Please note that this version of Ubuntu is no longer supported.

La instalación con APT puede realizarse con unos pocos comandos.Installing with APT can be done with a few commands. 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.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 un terminal y ejecute los comandos siguientes: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

Instalación del SDKInstall the SDK

El SDK de .NET Core permite desarrollar aplicaciones con .NET Core..NET Core SDK allows you to develop apps with .NET Core. Si instala el SDK de .NET Core, no necesita instalar el entorno de ejecución correspondiente.If you install .NET Core SDK, you don't need to install the corresponding runtime. Para instalar el SDK de .NET Core, ejecute los siguientes comandos:To install .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

Si recibe un mensaje de error similar a No se puede encontrar el paquete dotnet-sdk-2.1, consulte la sección Solución de problemas de APT.If you receive an error message similar to Unable to locate package dotnet-sdk-2.1, see the APT troubleshooting section.

Instalación de la instancia en tiempo de ejecuciónInstall the runtime

.NET Core Runtime le permite ejecutar aplicaciones que se realizaron con .NET Core que no incluían el entorno de ejecución.The .NET Core Runtime allows you to run apps that were made with .NET Core that didn't include the runtime. Los siguientes comandos instalan el entorno de ejecución de ASP.NET Core, que es el entorno de ejecución más compatible con .NET Core.The commands below install the ASP.NET Core Runtime, which is the most compatible runtime for .NET Core. En el terminal, ejecute los comandos siguientes.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

Si recibe un mensaje de error similar a No se puede encontrar el paquete aspnetcore-runtime-2.1, consulte la sección Solución de problemas de APT.If you receive an error message similar to Unable to locate package aspnetcore-runtime-2.1, see the APT troubleshooting section.

Una alternativa al entorno de ejecución de ASP.NET Core es instalar la instancia de .NET Core Runtime que no incluye compatibilidad con ASP.NET Core. Reemplace aspnetcore-runtime-2.1 en los comandos anteriores por dotnet-runtime-2.1.As an alternative to the ASP.NET Core Runtime, you can install the .NET Core Runtime that doesn't include ASP.NET Core support: replace aspnetcore-runtime-2.1 in the command above with dotnet-runtime-2.1.

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

18.04 ✔️18.04 ✔️

La instalación con APT puede realizarse con unos pocos comandos.Installing with APT can be done with a few commands. 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.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 un terminal y ejecute los comandos siguientes: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

Instalación del SDKInstall the SDK

El SDK de .NET Core permite desarrollar aplicaciones con .NET Core..NET Core SDK allows you to develop apps with .NET Core. Si instala el SDK de .NET Core, no necesita instalar el entorno de ejecución correspondiente.If you install .NET Core SDK, you don't need to install the corresponding runtime. Para instalar el SDK de .NET Core, ejecute los siguientes comandos:To install .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

Si recibe un mensaje de error similar a No se puede encontrar el paquete dotnet-sdk-3.1, consulte la sección Solución de problemas de APT.If you receive an error message similar to Unable to locate package dotnet-sdk-3.1, see the APT troubleshooting section.

Instalación de la instancia en tiempo de ejecuciónInstall the runtime

.NET Core Runtime le permite ejecutar aplicaciones que se realizaron con .NET Core que no incluían el entorno de ejecución.The .NET Core Runtime allows you to run apps that were made with .NET Core that didn't include the runtime. Los siguientes comandos instalan el entorno de ejecución de ASP.NET Core, que es el entorno de ejecución más compatible con .NET Core.The commands below install the ASP.NET Core Runtime, which is the most compatible runtime for .NET Core. En el terminal, ejecute los comandos siguientes.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

Si recibe un mensaje de error similar a No se puede encontrar el paquete aspnetcore-runtime-3.1, consulte la sección Solución de problemas de APT.If you receive an error message similar to Unable to locate package aspnetcore-runtime-3.1, see the APT troubleshooting section.

Una alternativa al entorno de ejecución de ASP.NET Core es instalar la instancia de .NET Core Runtime que no incluye compatibilidad con ASP.NET Core. Reemplace aspnetcore-runtime-3.1 en los comandos anteriores por dotnet-runtime-3.1.As an alternative to the ASP.NET Core Runtime, you can install the .NET Core Runtime that doesn't include ASP.NET Core support: replace aspnetcore-runtime-3.1 in the command above with dotnet-runtime-3.1.

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

17.10 ❌17.10 ❌

❌ Tenga en cuenta que ya no se admite esta versión de Ubuntu.❌ Please note that this version of Ubuntu is no longer supported.

La instalación con APT puede realizarse con unos pocos comandos.Installing with APT can be done with a few commands. 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.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 un terminal y ejecute los comandos siguientes: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

Instalación del SDKInstall the SDK

El SDK de .NET Core permite desarrollar aplicaciones con .NET Core..NET Core SDK allows you to develop apps with .NET Core. Si instala el SDK de .NET Core, no necesita instalar el entorno de ejecución correspondiente.If you install .NET Core SDK, you don't need to install the corresponding runtime. Para instalar el SDK de .NET Core, ejecute los siguientes comandos:To install .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

Si recibe un mensaje de error similar a No se puede encontrar el paquete dotnet-sdk-2.1, consulte la sección Solución de problemas de APT.If you receive an error message similar to Unable to locate package dotnet-sdk-2.1, see the APT troubleshooting section.

Instalación de la instancia en tiempo de ejecuciónInstall the runtime

.NET Core Runtime le permite ejecutar aplicaciones que se realizaron con .NET Core que no incluían el entorno de ejecución.The .NET Core Runtime allows you to run apps that were made with .NET Core that didn't include the runtime. Los siguientes comandos instalan el entorno de ejecución de ASP.NET Core, que es el entorno de ejecución más compatible con .NET Core.The commands below install the ASP.NET Core Runtime, which is the most compatible runtime for .NET Core. En el terminal, ejecute los comandos siguientes.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

Si recibe un mensaje de error similar a No se puede encontrar el paquete aspnetcore-runtime-2.1, consulte la sección Solución de problemas de APT.If you receive an error message similar to Unable to locate package aspnetcore-runtime-2.1, see the APT troubleshooting section.

Una alternativa al entorno de ejecución de ASP.NET Core es instalar la instancia de .NET Core Runtime que no incluye compatibilidad con ASP.NET Core. Reemplace aspnetcore-runtime-2.1 en los comandos anteriores por dotnet-runtime-2.1.As an alternative to the ASP.NET Core Runtime, you can install the .NET Core Runtime that doesn't include ASP.NET Core support: replace aspnetcore-runtime-2.1 in the command above with dotnet-runtime-2.1.

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

17.04 ❌17.04 ❌

❌ Tenga en cuenta que ya no se admite esta versión de Ubuntu.❌ Please note that this version of Ubuntu is no longer supported.

La instalación con APT puede realizarse con unos pocos comandos.Installing with APT can be done with a few commands. 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.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 un terminal y ejecute los comandos siguientes: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

Instalación del SDKInstall the SDK

El SDK de .NET Core permite desarrollar aplicaciones con .NET Core..NET Core SDK allows you to develop apps with .NET Core. Si instala el SDK de .NET Core, no necesita instalar el entorno de ejecución correspondiente.If you install .NET Core SDK, you don't need to install the corresponding runtime. Para instalar el SDK de .NET Core, ejecute los siguientes comandos:To install .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

Si recibe un mensaje de error similar a No se puede encontrar el paquete dotnet-sdk-2.1, consulte la sección Solución de problemas de APT.If you receive an error message similar to Unable to locate package dotnet-sdk-2.1, see the APT troubleshooting section.

Instalación de la instancia en tiempo de ejecuciónInstall the runtime

.NET Core Runtime le permite ejecutar aplicaciones que se realizaron con .NET Core que no incluían el entorno de ejecución.The .NET Core Runtime allows you to run apps that were made with .NET Core that didn't include the runtime. Los siguientes comandos instalan el entorno de ejecución de ASP.NET Core, que es el entorno de ejecución más compatible con .NET Core.The commands below install the ASP.NET Core Runtime, which is the most compatible runtime for .NET Core. En el terminal, ejecute los comandos siguientes.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

Si recibe un mensaje de error similar a No se puede encontrar el paquete aspnetcore-runtime-2.1, consulte la sección Solución de problemas de APT.If you receive an error message similar to Unable to locate package aspnetcore-runtime-2.1, see the APT troubleshooting section.

Una alternativa al entorno de ejecución de ASP.NET Core es instalar la instancia de .NET Core Runtime que no incluye compatibilidad con ASP.NET Core. Reemplace aspnetcore-runtime-2.1 en los comandos anteriores por dotnet-runtime-2.1.As an alternative to the ASP.NET Core Runtime, you can install the .NET Core Runtime that doesn't include ASP.NET Core support: replace aspnetcore-runtime-2.1 in the command above with dotnet-runtime-2.1.

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

16.10 ❌16.10 ❌

❌ Tenga en cuenta que ya no se admite esta versión de Ubuntu.❌ Please note that this version of Ubuntu is no longer supported.

La instalación con APT puede realizarse con unos pocos comandos.Installing with APT can be done with a few commands. 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.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 un terminal y ejecute los comandos siguientes: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

Instalación del SDKInstall the SDK

El SDK de .NET Core permite desarrollar aplicaciones con .NET Core..NET Core SDK allows you to develop apps with .NET Core. Si instala el SDK de .NET Core, no necesita instalar el entorno de ejecución correspondiente.If you install .NET Core SDK, you don't need to install the corresponding runtime. Para instalar el SDK de .NET Core, ejecute los siguientes comandos:To install .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

Si recibe un mensaje de error similar a No se puede encontrar el paquete dotnet-sdk-2.1, consulte la sección Solución de problemas de APT.If you receive an error message similar to Unable to locate package dotnet-sdk-2.1, see the APT troubleshooting section.

Instalación de la instancia en tiempo de ejecuciónInstall the runtime

.NET Core Runtime le permite ejecutar aplicaciones que se realizaron con .NET Core que no incluían el entorno de ejecución.The .NET Core Runtime allows you to run apps that were made with .NET Core that didn't include the runtime. Los siguientes comandos instalan el entorno de ejecución de ASP.NET Core, que es el entorno de ejecución más compatible con .NET Core.The commands below install the ASP.NET Core Runtime, which is the most compatible runtime for .NET Core. En el terminal, ejecute los comandos siguientes.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

Si recibe un mensaje de error similar a No se puede encontrar el paquete aspnetcore-runtime-2.1, consulte la sección Solución de problemas de APT.If you receive an error message similar to Unable to locate package aspnetcore-runtime-2.1, see the APT troubleshooting section.

Una alternativa al entorno de ejecución de ASP.NET Core es instalar la instancia de .NET Core Runtime que no incluye compatibilidad con ASP.NET Core. Reemplace aspnetcore-runtime-2.1 en los comandos anteriores por dotnet-runtime-2.1.As an alternative to the ASP.NET Core Runtime, you can install the .NET Core Runtime that doesn't include ASP.NET Core support: replace aspnetcore-runtime-2.1 in the command above with dotnet-runtime-2.1.

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

16.04 ✔️16.04 ✔️

La instalación con APT puede realizarse con unos pocos comandos.Installing with APT can be done with a few commands. 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.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 un terminal y ejecute los comandos siguientes: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

Instalación del SDKInstall the SDK

El SDK de .NET Core permite desarrollar aplicaciones con .NET Core..NET Core SDK allows you to develop apps with .NET Core. Si instala el SDK de .NET Core, no necesita instalar el entorno de ejecución correspondiente.If you install .NET Core SDK, you don't need to install the corresponding runtime. Para instalar el SDK de .NET Core, ejecute los siguientes comandos:To install .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

Si recibe un mensaje de error similar a No se puede encontrar el paquete dotnet-sdk-3.1, consulte la sección Solución de problemas de APT.If you receive an error message similar to Unable to locate package dotnet-sdk-3.1, see the APT troubleshooting section.

Instalación de la instancia en tiempo de ejecuciónInstall the runtime

.NET Core Runtime le permite ejecutar aplicaciones que se realizaron con .NET Core que no incluían el entorno de ejecución.The .NET Core Runtime allows you to run apps that were made with .NET Core that didn't include the runtime. Los siguientes comandos instalan el entorno de ejecución de ASP.NET Core, que es el entorno de ejecución más compatible con .NET Core.The commands below install the ASP.NET Core Runtime, which is the most compatible runtime for .NET Core. En el terminal, ejecute los comandos siguientes.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

Si recibe un mensaje de error similar a No se puede encontrar el paquete aspnetcore-runtime-3.1, consulte la sección Solución de problemas de APT.If you receive an error message similar to Unable to locate package aspnetcore-runtime-3.1, see the APT troubleshooting section.

Una alternativa al entorno de ejecución de ASP.NET Core es instalar la instancia de .NET Core Runtime que no incluye compatibilidad con ASP.NET Core. Reemplace aspnetcore-runtime-3.1 en los comandos anteriores por dotnet-runtime-3.1.As an alternative to the ASP.NET Core Runtime, you can install the .NET Core Runtime that doesn't include ASP.NET Core support: replace aspnetcore-runtime-3.1 in the command above with dotnet-runtime-3.1.

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

SDK o entorno de ejecución de actualización de APTAPT update SDK or runtime

Cuando hay disponible una nueva versión de revisión para .NET Core, basta con que la actualice mediante APT con los siguientes comandos:When a new patch release is available for .NET Core, you can simply upgrade it through APT with the following commands:

sudo apt-get update
sudo apt-get upgrade

Solución de problemas de APTAPT troubleshooting

En esta sección se proporciona información sobre los errores comunes que puede recibir al usar ATP para instalar .NET Core.This section provides information on common errors you may get while using APT to install .NET Core.

No se puede encontrar el paqueteUnable to find package

Las instalaciones del administrador de paquetes solo se admiten en la arquitectura x64.Package manager installs are only supported on the x64 architecture. Otras arquitecturas, como ARM, deben instalar manualmente el SDK de .NET Core o .NET Core Runtime.Other architectures, such as ARM, must manually install the .NET Core SDK or .NET Core Runtime. Para obtener más información, vea la sección Instalación manual.For more information, see the manually install section.

No se puede encontrar el paquete \ No se han podido instalar algunos paquetesUnable to locate \ Some packages could not be installed

Si recibe un mensaje de error similar a No se puede encontrar el paquete {netcore-package} o No se han podido instalar algunos paquetes, ejecute los comandos siguientes.If you receive an error message similar to Unable to locate package {netcore-package} or Some packages could not be installed, run the following commands.

Hay dos marcadores de posición en el siguiente conjunto de comandos.There are two placeholders in the following set of commands.

  • {dotnet-package}
    Representa el paquete de .NET Core que va a instalar, como aspnetcore-runtime-3.1.This represents the .NET Core package you're installing, such as aspnetcore-runtime-3.1. Se usa en el comando sudo apt-get install siguiente.This is used in the sudo apt-get install command below.

  • {os-version}
    Representa la versión de Linux en la que está.This represents the Linux version you are on. Se usa en el comando wget siguiente.This is used in the wget command below.

Primero, pruebe a purgar la lista de paquetes:First, try purging the package list:

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

Después, intente instalar .NET Core de nuevo.Then, try to install .NET Core again. Si eso no funciona, puede ejecutar una instalación manual con los comandos siguientes: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}

No se pudo capturar el elementoFailed to fetch

Al instalar el paquete de .NET Core, puede ver un error similar a Failed to fetch ... File has unexpected size ... Mirror sync in progress?.While installing the .NET Core package, you may see an error similar to Failed to fetch ... File has unexpected size ... Mirror sync in progress?. Este error significa que la fuente de paquetes de .NET Core se está actualizando con versiones de paquetes más recientes y que debe volver a intentarlo más tarde.This error could mean that the package feed for .NET Core is being upgraded with newer package versions, and that you should try again later. Durante una actualización, la falta de disponibilidad de la fuente de paquetes no debe ser superior a 30 minutos.During an upgrade, the package feed shouldn't be unavailable for more than 30 minutes. Si recibe este error continuamente durante más de 30 minutos, abra una incidencia en 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.

SnapSnap

.NET Core está disponible desde el almacén de snaps..NET Core is available from the Snap Store.

Un snap es una agrupación de una aplicación y sus dependencias que funcionan sin modificaciones en muchas distribuciones de Linux diferentes.A snap is a bundle of an app and its dependencies that works without modification across many different Linux distributions. Los snaps se reconocen y se instalan desde el almacén de snaps.Snaps are discoverable and installable from the Snap Store. Para más información sobre Snap, consulte Introducción a Snap.For more information about Snap, see Getting started with Snap.

Solo las versiones admitidas de .NET Core están disponibles mediante Snap.Only supported versions of .NET Core are available through Snap.

Instalación del SDKInstall the SDK

Los paquetes Snap para el SDK de .NET Core se publican con el mismo identificador: dotnet-sdk.Snap packages for .NET Core SDK are all published under the same identifier: dotnet-sdk. Se puede instalar una versión específica del SDK mediante la especificación del canal.A specific version of the SDK can be installed by specifying the channel. El SDK incluye el entorno de ejecución correspondiente.The SDK includes the coresponding runtime. En la tabla siguiente se enumeran los canales:The following table list the channels:

Versión de .NET Core.NET Core version Paquete SnapSnap package
3.1 (LTS)3.1 (LTS) 3.1 o latest/stable3.1 or latest/stable
2.1 (LTS)2.1 (LTS) 2.1
.NET 5.0 (versión preliminar).NET 5.0 preview 5.0/beta

Use el comando snap install para instalar un paquete Snap del SDK de .NET Core.Use the snap install command to install a .NET Core SDK snap package. Use el parámetro --channel para indicar qué versión se va a instalar.Use the --channel parameter to indicate which version to install. Si se omite este parámetro, se usa latest/stable.If this parameter is omitted, latest/stable is used. En este ejemplo, se especifica 3.1:In this example, 3.1 is specified:

sudo snap install dotnet-sdk --classic --channel=3.1

A continuación, registre el comando dotnet del sistema con el comando snap alias:Next, register the dotnet command for the system with the snap alias command:

sudo snap alias dotnet-sdk.dotnet dotnet

Este comando tiene el formato sudo snap alias {package}.{command} {alias}.This command is formatted as: sudo snap alias {package}.{command} {alias}. Puede elegir cualquier nombre de {alias} que prefiera.You can choose any {alias} name you would like. Por ejemplo, puede asignar un nombre al comando después de la versión específica instalada por el snap sudo snap alias dotnet-sdk.dotnet dotnet31.For example, you could name the command after the specific version installed by snap: sudo snap alias dotnet-sdk.dotnet dotnet31. Cuando use el comando dotnet31, invocará esta versión específica de .NET.When you use the command dotnet31, you'll invoke this specific version of .NET. Sin embargo, esta operación no es compatible con la mayoría de los tutoriales y ejemplos, donde se espera que esté disponible un comando dotnet.But this is incompatible with most tutorials and examples as they expect a dotnet command to be available.

Instalación de la instancia en tiempo de ejecuciónInstall the runtime

Los paquetes Snap de .NET Core Runtime se publican con su propio identificador de paquete.Snap packages for .NET Core Runtime are each published under their own package identifier. En la tabla siguiente se muestra una lista de los identificadores de paquete:The following table lists the package identifiers:

Versión de .NET Core.NET Core version Paquete SnapSnap package
3.1 (LTS)3.1 (LTS) dotnet-runtime-31
3.03.0 dotnet-runtime-30
2.22.2 dotnet-runtime-22
2.1 (LTS)2.1 (LTS) dotnet-runtime-21

Use el comando snap install para instalar un paquete Snap de .NET Core Runtime.Use the snap install command to install a .NET Core Runtime snap package. En este ejemplo, se instala .NET Core 3.1:In this example, .NET Core 3.1 is installed:

sudo snap install dotnet-runtime-31 --classic

A continuación, registre el comando dotnet del sistema con el comando snap alias:Next, register the dotnet command for the system with the snap alias command:

sudo snap alias dotnet-runtime-31.dotnet dotnet

Este comando tiene el formato sudo snap alias {package}.{command} {alias}.This command is formatted as: sudo snap alias {package}.{command} {alias}. Puede elegir cualquier nombre de {alias} que prefiera.You can choose any {alias} name you would like. Por ejemplo, puede asignar un nombre al comando después de la versión específica instalada por el snap sudo snap alias dotnet-runtime-31.dotnet dotnet31.For example, you could name the command after the specific version installed by snap: sudo snap alias dotnet-runtime-31.dotnet dotnet31. Cuando use el comando dotnet31, invocará esta versión específica de .NET.When you use the command dotnet31, you'll invoke this specific version of .NET. Sin embargo, esta operación no es compatible con la mayoría de los tutoriales y ejemplos, donde se espera que esté disponible un comando dotnet.But this is incompatible with most tutorials and examples as they expect a dotnet command to be available.

Errores de certificado SSLSSL Certificate errors

Cuando .NET se instala mediante Snap, es posible que en algunas distribuciones no se encuentren los certificados SSL de .NET y que reciba un error similar al siguiente durante la acción restore:When .NET is installed through Snap, it's possible that on some distros the .NET SSL certificates may not be found and you may receive an error similar to the following during restore:

Processing post-creation actions...
Running 'dotnet restore' on /home/myhome/test/test.csproj...
  Restoring packages for /home/myhome/test/test.csproj...
/snap/dotnet-sdk/27/sdk/2.2.103/NuGet.targets(114,5): error : Unable to load the service index for source https://api.nuget.org/v3/index.json. [/home/myhome/test/test.csproj]
/snap/dotnet-sdk/27/sdk/2.2.103/NuGet.targets(114,5): error :   The SSL connection could not be established, see inner exception. [/home/myhome/test/test.csproj]
/snap/dotnet-sdk/27/sdk/2.2.103/NuGet.targets(114,5): error :   The remote certificate is invalid according to the validation procedure. [/home/myhome/test/test.csproj]

Para resolver este problema, establezca algunas variables de entorno:To resolve this issue, set a few enviornment variables:

export SSL_CERT_FILE=[path-to-certificate-file]
export SSL_CERT_DIR=/dev/null

La ubicación del certificado variará en función de la distribución.The certificate location will vary by distro. Estas son las ubicaciones de las distribuciones en las que hemos experimentado el problema.Here are the locations for the distros where we have experienced the issue.

  • Fedora: /etc/pki/ca-trust/extracted/pem/tls-ca-bundle.pemFedora - /etc/pki/ca-trust/extracted/pem/tls-ca-bundle.pem
  • OpenSUSE: /etc/ssl/ca-bundle.pemOpenSUSE - /etc/ssl/ca-bundle.pem
  • Solus: /etc/ssl/certs/ca-certificates.crtSolus - /etc/ssl/certs/ca-certificates.crt

DependenciasDependencies

Al realizar la instalación con un administrador de paquetes, estas bibliotecas se instalan automáticamente.When you install with a package manager, these libraries are installed for you. Sin embargo, si instala manualmente .NET Core o publica una aplicación independiente, deberá asegurarse de que estas bibliotecas estén instaladas:But, if you manually install .NET Core 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)
  • libssl1.0.0 (para 14.x, 16.x)libssl1.0.0 (for 14.x, 16.x)
  • libssl1.1 (para 18.x, 20.x)libssl1.1 (for 18.x, 20.x)
  • libstdc++6libstdc++6
  • zlib1gzlib1g

En el caso de las aplicaciones de .NET Core que utilizan el ensamblado System.Drawing.Common, también se necesita la dependencia siguiente:For .NET Core apps that use the System.Drawing.Common assembly, you also need the following dependency:

Instalación con scriptScripted install

Los scripts de dotnet-install se usan para la automatización y las instalaciones que no son de administrador del SDK y del Runtime.The dotnet-install scripts are used for automation and non-admin installs of the SDK and Runtime. Puede descargar el script de https://dot.net/v1/dotnet-install.sh.You can download the script from https://dot.net/v1/dotnet-install.sh.

El valor predeterminado del script es instalar la versión más reciente del SDK de soporte técnico a largo plazo (LTS), que actualmente es .NET Core 3.1.The script defaults to installing the latest SDK long term support (LTS) version, which is .NET Core 3.1. Para instalar la versión actual, que puede no ser una versión (LTS), use el parámetro -c Current.To install the current release, which may not be an (LTS) version, use the -c Current parameter.

./dotnet-install.sh -c Current

Para instalar .NET Core Runtime en lugar del SDK, use el parámetro --runtime.To install .NET Core Runtime instead of the SDK, use the --runtime parameter.

./dotnet-install.sh -c Current --runtime aspnetcore

Para instalar una versión específica, modifique el parámetro -c para indicar la versión específica.You can install a specific version by altering the -c parameter to indicate the specific version. El siguiente comando instala el SDK de .NET Core 3.1.The following command installs .NET Core SDK 3.1.

./dotnet-install.sh -c 3.1

Para más información, consulte la referencia de los scripts de dotnet-install.For more information, see dotnet-install scripts reference.

Instalación manualManual install

Como alternativa a los administradores de paquetes, puede descargar e instalar manualmente el SDK y el entorno de ejecución.As an alternative to the package managers, you can download and manually install the SDK and runtime. La instalación manual se suele llevar a cabo durante las pruebas de integración continua o en distribuciones de Linux no admitidas.Manual install is usually performed as part of continuous integration testing or on an unsupported Linux distribution. Para un desarrollador o usuario, generalmente es mejor usar un administrador de paquetes.For a developer or user, it's generally better to use a package manager.

Si instala el SDK de .NET Core, no necesita instalar el entorno de ejecución correspondiente.If you install .NET Core SDK, you don't need to install the corresponding runtime. En primer lugar, descargue una versión binaria del SDK o del entorno de ejecución de uno de los siguientes sitios:First, download a binary release for either the SDK or the runtime from one of the following sites:

A continuación, extraiga el archivo descargado y use el comando export para establecer las variables que se utilizan en .NET Core. Luego, asegúrese de que .NET Core esté en PATH.Next, extract the downloaded file and use the export command to set variables used by .NET Core and then ensure .NET Core is in PATH.

Para extraer el entorno de ejecución y hacer que los comandos de la CLI de .NET Core estén disponibles en el terminal, en primer lugar, descargue una versión binaria de .NET Core.To extract the runtime and make the .NET Core CLI commands available at the terminal, first download a .NET Core binary release. Luego, abra un terminal y ejecute los siguientes comandos desde el directorio donde se guardó el archivo.Then, open a terminal and run the following commands from the directory where the file was saved. El nombre del archivo puede ser distinto en función de lo que haya descargado.The archive file name may be different depending on what you downloaded.

Use el comando siguiente para extraer el entorno de ejecución:Use the following command to extract the runtime:

mkdir -p "$HOME/dotnet" && tar zxf aspnetcore-runtime-3.1.0-linux-x64.tar.gz -C "$HOME/dotnet"
export DOTNET_ROOT=$HOME/dotnet
export PATH=$PATH:$HOME/dotnet

Use el comando siguiente para extraer el SDK:Use the following command to extract the SDK:

mkdir -p "$HOME/dotnet" && tar zxf dotnet-sdk-3.1.301-linux-x64.tar.gz -C "$HOME/dotnet"
export DOTNET_ROOT=$HOME/dotnet
export PATH=$PATH:$HOME/dotnet

Sugerencia

Los comandos export anteriores solo hacen que los comandos de la CLI de .NET Core estén disponibles para la sesión de terminal en la que se ha ejecutado.The preceding export commands only make the .NET Core CLI commands available for the terminal session in which it was run.

Puede editar el perfil del shell para agregar los comandos de forma permanente.You can edit your shell profile to permanently add the commands. Hay una serie de shells distintos disponibles para Linux, y cada uno de ellos tiene un perfil diferente.There are a number of different shells available for Linux and each has a different profile. Por ejemplo:For example:

  • Shell de Bash: ~/.bash_profile, ~/.bashrcBash Shell: ~/.bash_profile, ~/.bashrc
  • Shell de Korn: ~/.kshrc or .profileKorn Shell: ~/.kshrc or .profile
  • Shell de Z: ~/.zshrc or .zprofileZ Shell: ~/.zshrc or .zprofile

Edite el archivo de origen adecuado para el shell y agregue :$HOME/dotnet al final de la instrucción PATH existente.Edit the appropriate source file for your shell and add :$HOME/dotnet to the end of the existing PATH statement. Si no se incluye ninguna instrucción PATH, agregue una nueva línea con export PATH=$PATH:$HOME/dotnet.If no PATH statement is included, add a new line with export PATH=$PATH:$HOME/dotnet.

Además, agregue export DOTNET_ROOT=$HOME/dotnet al final del archivo.Also, add export DOTNET_ROOT=$HOME/dotnet to the end of the file.

Este enfoque le permite instalar diferentes versiones en ubicaciones independientes y elegir explícitamente cuál usará cada aplicación.This approach lets you install different versions into separate locations and choose explicitly which one to use by which application.

Pasos siguientesNext steps