Partage via

Installer le Kit de développement logiciel (SDK) .NET ou le runtime .NET sur Debian

Cet article explique comment installer .NET sur Debian. Lorsqu'une version de Debian n'est plus prise en charge, .NET n'est plus supporté sur cette version. Toutefois, ces instructions peuvent vous aider à obtenir .NET en cours d'exécution sur ces versions, même si elles ne sont pas prises en charge.

Installez le Kit de développement logiciel (SDK) (qui inclut le runtime) si vous souhaitez développer des applications .NET. Ou, si vous avez uniquement besoin d’exécuter des applications, installez le runtime. Si vous installez le runtime, nous vous suggérons d'installer le runtime ASP.NET Core runtime car il inclut à la fois des .NET et des runtimes ASP.NET Core.

Utilisez les commandes et pour voir quelles versions sont installées. Pour plus d’informations, consultez How to check that .NET is already installed.

Distributions prises en charge

Le tableau suivant répertorie les versions de .NET actuellement prises en charge et les versions de Debian sur lesquelles elles sont prises en charge. Ces versions restent prises en charge jusqu’à ce que la version de .NET atteigne la fin de la prise en charge ou que la version de Debian atteint la fin de vie.

Debian .NET
13 10, 9, 8
12 10, 9, 8

Les versions suivantes de .NET ne sont plus prises en charge :

  • .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

Installer des préversions

Les versions d'évaluation et de version candidate de .NET ne sont pas disponibles dans les référentiels de package. Vous pouvez installer des préversions et des candidats à la publication de .NET de l’une des manières suivantes :

  • Installation par script avec install-dotnet.sh
  • Extraction binaire manuelle

Supprimer des préversions

Lorsque vous utilisez un gestionnaire de package pour gérer votre installation de .NET, vous risquez de rencontrer un conflit si vous avez déjà installé une préversion. Le gestionnaire de package peut interpréter la version non préliminaire comme une version antérieure de .NET. Pour installer la version qui ne correspond pas à la préversion, désinstallez d’abord les préversions. Pour plus d’informations sur la désinstallation de .NET, consultez How to remove the .NET Runtime and SDK.

Debian 13

L’installation avec APT peut être effectuée à l’aide de quelques commandes. Avant d’installer .NET, exécutez les commandes suivantes pour ajouter la clé de signature de package Microsoft à votre liste de clés approuvées et ajoutez le référentiel de packages.

Ouvrez un terminal et exécutez les commandes suivantes :

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

Importante

Le flux de package Microsoft publie uniquement des packages x64 et Arm64 pour .NET 10. Si vous devez installer .NET sur d'autres architectures, telles que Arm32, n'utilisez pas de gestionnaire de package avec le flux de package Microsoft. Pour plus d’informations sur l’installation de .NET without a package manager, consultez l’un des articles suivants :

Installer le SDK

Le sdk .NET vous permet de développer des applications avec .NET. Si vous installez le Kit de développement logiciel (SDK) .NET, vous n'avez pas besoin d'installer le runtime correspondant. Pour installer le Kit de développement logiciel (SDK) .NET, exécutez les commandes suivantes :

sudo apt-get update && \
  sudo apt-get install -y dotnet-sdk-10.0

Pour savoir comment utiliser l’interface CLI .NET, consultez .NET vue d’ensemble de l’interface CLI.

Installer le runtime

Le runtime ASP.NET Core vous permet d'exécuter des applications qui ont été effectuées avec .NET qui n'ont pas fourni le runtime. Les commandes suivantes installent le runtime ASP.NET Core, qui est le runtime le plus compatible pour .NET. Dans votre terminal, exécutez les commandes suivantes :

sudo apt-get update && \
  sudo apt-get install -y aspnetcore-runtime-10.0

En guise d'alternative au runtime ASP.NET Core, vous pouvez installer le runtime .NET, qui n'inclut pas ASP.NET Core prise en charge : remplacez aspnetcore-runtime-10.0 dans la commande précédente par dotnet-runtime-10.0 :

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

Pour savoir comment utiliser l’interface CLI .NET, consultez .NET vue d’ensemble de l’interface CLI.

Debian 12

L’installation avec APT peut être effectuée à l’aide de quelques commandes. Avant d’installer .NET, exécutez les commandes suivantes pour ajouter la clé de signature de package Microsoft à votre liste de clés approuvées et ajoutez le référentiel de packages.

Ouvrez un terminal et exécutez les commandes suivantes :

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

Importante

Le flux de package Microsoft publie uniquement des packages x64 et Arm64 pour .NET 10. Si vous devez installer .NET sur d'autres architectures, telles que Arm32, n'utilisez pas de gestionnaire de package avec le flux de package Microsoft. Pour plus d’informations sur l’installation de .NET without a package manager, consultez l’un des articles suivants :

Installer le SDK

Le sdk .NET vous permet de développer des applications avec .NET. Si vous installez le Kit de développement logiciel (SDK) .NET, vous n'avez pas besoin d'installer le runtime correspondant. Pour installer le Kit de développement logiciel (SDK) .NET, exécutez les commandes suivantes :

sudo apt-get update && \
  sudo apt-get install -y dotnet-sdk-10.0

Pour savoir comment utiliser l’interface CLI .NET, consultez .NET vue d’ensemble de l’interface CLI.

Installer le runtime

Le runtime ASP.NET Core vous permet d'exécuter des applications qui ont été effectuées avec .NET qui n'ont pas fourni le runtime. Les commandes suivantes installent le runtime ASP.NET Core, qui est le runtime le plus compatible pour .NET. Dans votre terminal, exécutez les commandes suivantes :

sudo apt-get update && \
  sudo apt-get install -y aspnetcore-runtime-10.0

En guise d'alternative au runtime ASP.NET Core, vous pouvez installer le runtime .NET, qui n'inclut pas ASP.NET Core prise en charge : remplacez aspnetcore-runtime-10.0 dans la commande précédente par dotnet-runtime-10.0 :

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

Pour savoir comment utiliser l’interface CLI .NET, consultez .NET vue d’ensemble de l’interface CLI.

Utiliser APT pour mettre à jour .NET

Lorsqu’une nouvelle version de correctif est disponible pour .NET, vous pouvez la mettre à niveau via APT avec les commandes suivantes :

sudo apt-get update
sudo apt-get upgrade

Si vous avez mis à niveau votre distribution Linux depuis l’installation de .NET, vous devrez peut-être reconfigurer le référentiel de package Microsoft. Exécutez les instructions d’installation de votre version de distribution actuelle pour effectuer une mise à niveau vers le référentiel de packages approprié pour .NET mises à jour.

Dépannage

Cette section fournit des informations sur les erreurs courantes que vous pouvez obtenir lors de l’utilisation d’APT pour installer .NET.

Le package est introuvable

Importante

Le flux de package Microsoft publie des packages pour différentes architectures en fonction de la version .NET :

  • .NET 10 : x64 et Arm64 packages uniquement.
  • .NET 9 : paquets x64 uniquement.
  • .NET 8 : x64 packages uniquement.

Si vous devez installer .NET sur d'autres architectures, telles que Arm32, n'utilisez pas de gestionnaire de package avec le flux de package Microsoft. Pour plus d’informations sur l’installation de .NET without a package manager, consultez l’un des articles suivants :

Package introuvable\Certains packages n’ont pas pu être installés

Si vous recevez un message d’erreur semblable à Le package {dotnet-package} est introuvable ou Certains packages n’ont pas pu être installés, exécutez les commandes suivantes.

Il existe deux espaces réservés dans l’ensemble de commandes suivant.

  • {dotnet-package}
    Cela représente le package .NET que vous installez, tel que aspnetcore-runtime-8.0. Il est utilisé dans la commande suivante.

Commencez par essayer de vider la liste des packages :

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

Ensuite, réessayez d’installer .NET. Si cela ne fonctionne pas, vous pouvez effectuer une installation manuelle avec les commandes suivantes :

Si vous utilisez Debian 12 ou une version ultérieure, essayez les commandes suivantes :

# Get OS version info which adds the $ID and $VERSION_ID variables
source /etc/os-release

# Download the Microsoft keys
sudo apt-get install -y gpg wget
wget https://packages.microsoft.com/keys/microsoft.asc
cat microsoft.asc | gpg --dearmor -o microsoft.asc.gpg

# Add the Microsoft repository to the system's sources list
wget https://packages.microsoft.com/config/$ID/$VERSION_ID/prod.list
sudo mv prod.list /etc/apt/sources.list.d/microsoft-prod.list

# Move the key to the appropriate place
sudo mv microsoft.asc.gpg $(cat /etc/apt/sources.list.d/microsoft-prod.list | grep -oP "(?<=signed-by=).*(?=\])")

# Update packages and install .NET
sudo apt-get update && \
  sudo apt-get install -y {dotnet-package}

Si vous utilisez une version Debian antérieure à 12, essayez les commandes suivantes :

# Define the OS version, name, and codename
source /etc/os-release

# Download the Microsoft keys
sudo apt-get install -y gpg wget
wget https://packages.microsoft.com/keys/microsoft.asc
cat microsoft.asc | gpg --dearmor -o microsoft.asc.gpg
sudo mv microsoft.asc.gpg /etc/apt/trusted.gpg.d/

# Add the Microsoft repository to the system's sources list
wget https://packages.microsoft.com/config/$ID/$VERSION_ID/prod.list
sudo mv prod.list /etc/apt/sources.list.d/microsoft-prod.list

# Set ownership
sudo chown root:root /etc/apt/trusted.gpg.d/microsoft.asc.gpg
sudo chown root:root /etc/apt/sources.list.d/microsoft-prod.list

# Update packages and install .NET
sudo apt-get update && \
  sudo apt-get install -y {dotnet-package}

Échec de la récupération

Lors de l’installation du package .NET, une erreur similaire à Failed to fetch ... File has unexpected size ... Mirror sync in progress? peut s’afficher. Cette erreur peut signifier que le flux de package pour .NET est mis à niveau avec les versions plus récentes du package, et que vous devez réessayer ultérieurement. Pendant une mise à niveau, le flux de paquets ne doit pas être indisponible pendant plus de 30 minutes. Si vous recevez continuellement cette erreur pendant plus de 30 minutes, veuillez signaler le problème à l’adresse .

Les dépendances

Lorsque vous effectuez une installation avec un gestionnaire de package, ces bibliothèques sont installées pour vous. Toutefois, si vous installez manuellement .NET ou que vous publiez une application autonome, vous devez vous assurer que ces bibliothèques sont installées :

13.x

  • libc6
  • libgcc-s1
  • libgssapi-krb5-2
  • libicu72
  • libssl3
  • libstdc++6
  • zlib1g

12.x

  • libc6
  • libgcc-s1
  • libgssapi-krb5-2
  • libicu72
  • libssl3
  • libstdc++6
  • zlib1g

Autres remarques

Les dépendances peuvent être installées avec la commande . L’extrait de code suivant illustre l’installation de la bibliothèque  :

sudo apt install libc6

Étapes suivantes

  • Last updated on