Handleiding voor beslissingen over het installeren van .NET op Ubuntu

In dit artikel kunt u bepalen hoe u .NET installeert op Ubuntu. Vanaf Ubuntu 22.04 zijn de meeste ondersteunde versies van .NET beschikbaar in de ingebouwde Ubuntu-feed. De pakketopslagplaats ubuntu .NET backports bevat de resterende ondersteunde .NET versies.

Canonical heeft de publicatie van .NET op Ubuntu overgenomen. Vanaf Ubuntu 22.04 distribueert Microsoft .NET voor Ubuntu niet meer naar de Microsoft-pakketopslagplaats.

Ondersteunde distributies

De volgende tabel is een lijst met momenteel ondersteunde .NET releases en de versies van Ubuntu waarop ze worden ondersteund. Elke koppeling gaat naar de specifieke Ubuntu-versiepagina met instructies voor het installeren van .NET voor die versie van Ubuntu.

Wanneer een Ubuntu-versie het einde van de ondersteuningsperiode bereikt, wordt .NET niet meer ondersteund voor die specifieke Ubuntu-versie.

Canonical ondersteunt .NET versies in de ingebouwde Ubuntu-feed voor de levensduur van die Ubuntu-versie, zelfs na de levensduur van de door Microsoft geleverde ondersteuning en biedt best effort-ondersteuning voor .NET versies in de .NET backports-pakketopslagplaats, die niet langer is dan de door Microsoft geleverde ondersteuningsduur.

De volgende versies van .NET worden ❌ niet meer ondersteund:

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

Overwegingen bij het upgraden van Ubuntu

Ubuntu upgraden naar 22.04 of hoger? Overweeg eerst .NET te verwijderen.

Als u een pakketbeheerder hebt gebruikt om .NET te installeren vanuit de Microsoft-pakketopslagplaats, treedt er na het upgraden van Ubuntu een probleem op met een pakketmix. Nu Canonical .NET publiceert naar de pakketfeeds voor Ubuntu 22.04 (en latere versies), weet de pakketbeheerder niet meer over de eerder geïnstalleerde .NET versie. De pakketten kunnen niet worden geüpgraded naar de meest recente .NET. Verwijder ze eerst en installeer ze vervolgens opnieuw vanuit de Ubuntu-pakketopslagplaats.

Bepalen hoe u .NET installeert

Wanneer uw versie van Ubuntu ondersteuning biedt voor .NET via de ingebouwde of .NET Ubuntu-feed, wordt ondersteuning voor deze builds van .NET geleverd door Canonical en zijn de builds mogelijk geoptimaliseerd voor verschillende workloads. Microsoft biedt ondersteuning voor pakketten in de Microsoft-pakketopslagplaatsfeed.

Gebruik de volgende secties om te bepalen hoe u .NET moet installeren:

• I gebruikt Ubuntu 22.04 of hoger en ik heb alleen .NET
• Ik gebruik een versie van Ubuntu vóór 22.04
• Ik gebruik andere Microsoft-pakketten, zoals powershell, mdatpof mssql
• I een .NET-app wilt maken
• I een .NET-app wilt uitvoeren in een container-, cloud- of continue integratiescenario
• My Ubuntu-distributie bevat niet de .NET versie die ik wil, of ik heb een out-of-support-.NET-versie nodig
• Ik wil een preview-versie installeren
• Ik wil APT niet gebruiken
• Ik gebruik een ARM-CPU
• Ik gebruik het IBM System Z- of Power-platform

Ik gebruik Ubuntu 22.04 of hoger en ik heb alleen .NET

Als u geen andere Microsoft-pakketten nodig hebt, zoals powershell, mdatp of mssql, installeert u .NET via de Ubuntu-feed. Zie de volgende pagina's voor meer informatie:

• Install .NET op Ubuntu 25.10.
• Install .NET on Ubuntu 25.04.
• Install .NET op Ubuntu 24.04.
• Install .NET on Ubuntu 22.04.

Als u de Microsoft-opslagplaats gaat installeren om andere Microsoft-pakketten te gebruiken, zoals powershell, mdatp of mssql, moet u de .NET-pakketten die door de Microsoft-opslagplaats worden geleverd, deprioritiseren. Zie My Linux-distributie biedt .NET pakketten en ik wil ze gebruiken voor instructies over het deprioriteren van de pakketten.

Ik gebruik een versie van Ubuntu vóór 22.04

Gebruik de instructies in de versiespecifieke sectie van Install .NET SDK of .NET Runtime op Ubuntu.

Raadpleeg de sectie Supported distributions voor meer informatie over welke versies van .NET worden ondersteund voor uw versie van Ubuntu. Als u een versie installeert die niet wordt ondersteund, zie De Microsoft-pakketopslagplaats registreren.

Ik gebruik andere Microsoft-pakketten, zoals powershell, mdatpof mssql

Als uw Ubuntu-versie .NET via een Ubuntu-feed ondersteunt, moet u beslissen welke feed .NET moet installeren. De sectie Supported distributions bevat een tabel waarin wordt vermeld welke versies van .NET beschikbaar zijn in de pakketfeeds.

Als u de .NET-pakketten wilt ophalen uit een Ubuntu-feed, moet u de .NET pakketten die door de Microsoft-opslagplaats worden geleverd, deprioritiseren. Zie My Linux-distributie biedt .NET pakketten en ik wil ze gebruiken voor instructies over het deprioriteren van de pakketten.

Ik wil een .NET-app maken

Gebruik dezelfde pakketbronnen voor de SDK als voor de runtime. Het wordt aanbevolen om .NET te installeren via een Ubuntu-feed. Als u echter .NET wilt installeren vanuit een andere bron (bijvoorbeeld de Microsoft-pakketopslagplaats voor toegang tot hogere SDK-functiebanden), moet u .NET verwijderen, uw pakketbeheerder configureren om .NET pakketten uit de Ubuntu-feed te negeren en opnieuw te installeren vanuit de andere bron.

Bekijk de andere suggesties in de sectie Decide hoe u .NET installeert.

Ik wil een .NET-app uitvoeren in een container-, cloud- of continue integratiescenario

Als uw Ubuntu-versie de .NET versie biedt die u nodig hebt, installeert u deze vanuit een Ubuntu-feed. Anders registreert u de Microsoft-pakketrepository en installeert u .NET vanuit die repository. Bekijk de informatie in de sectie Ondersteunde distributies .

Als de gewenste versie van .NET niet beschikbaar is, gebruikt u het script dotnet-install script.

Mijn Ubuntu-distributie bevat niet de .NET versie die ik wil, of ik heb een out-of-support-.NET versie nodig

U wordt aangeraden APT en de Microsoft-pakketopslagplaats te gebruiken. Zie de sectie Registreren en installeren met de microsoft-pakketopslagplaats voor meer informatie.

Ik wil een preview-versie installeren

Gebruik een van de volgende manieren om .NET te installeren:

• Installeer .NET met install-dotnet script.
• .NET handmatig installeren

Ik wil APT niet gebruiken

Als u een geautomatiseerde installatie wilt, gebruikt u het Linux-installatiescript.

Als u volledige controle wilt over de .NET-installatie, downloadt u een tarball en installeert u handmatig .NET. Zie Handmatig installeren voor meer informatie.

Ik gebruik een ARM-CPU

Als uw Ubuntu-versie de .NET versie biedt die u nodig hebt, installeert u deze vanuit de ingebouwde feed. Bekijk de informatie in de sectie Ondersteunde distributies .

Als de gewenste versie van .NET niet beschikbaar is, kunt u een van de volgende manieren gebruiken om .NET te installeren:

• Installeer .NET met install-dotnet script.
• Installeer .NET handmatig

Ik gebruik het IBM System Z- of Power-platform

Vanaf .NET 8 op Ubuntu 22.04 ondersteunt Canonical .NET voor de IBM System Z- en Power-platformen. Deze ondersteuning wordt voortgezet voor elke .NET release in de toekomst.

Installeer .NET via de ingebouwde Ubuntu-feed. Zie de volgende pagina voor meer informatie:

• Install .NET 10 op Ubuntu 25.10.

Een pakketopslagplaats registreren

Afhankelijk van uw versie van Ubuntu moet u mogelijk de Ubuntu-backports of de Microsoft-pakketopslagplaats registreren.

• Registreer de pakketopslagplaats voor Ubuntu .NET backports
• de Microsoft-pakketopslagplaats registreren

Ubuntu .NET-backports-pakketopslagplaats

De pakketopslagplaats ubuntu .NET backports biedt versies van .NET die niet beschikbaar zijn in de ingebouwde Ubuntu-feed. Canonical onderhoudt de pakketten in deze pakketopslagplaats en biedt best effort-ondersteuning, die niet langer is dan de door Microsoft geleverde ondersteuningsduur of de ondersteuningsperiode van de specifieke Ubuntu-versie.

Deze pakketopslagplaats wordt ondersteund op Ubuntu 24.04 LTS (Noble Numbat) en Ubuntu 22.04 LTS (Jammy Jellyfish). De sectie Supported distributions bevat een tabel waarin wordt vermeld welke versies van .NET beschikbaar zijn in de pakketfeed. Voor meer informatie, zie Ubuntu .NET backports pakketrepository.

Voer de volgende opdrachten uit om deze pakketopslagplaats toe te voegen:

sudo add-apt-repository ppa:dotnet/backports
sudo apt update

De pakketopslagplaats voor Ubuntu .NET backports registreren

Open een terminal en voer de volgende opdracht uit:

sudo add-apt-repository ppa:dotnet/backports

Registratie van de ubuntu-.NET backportspakketopslagplaats ongedaan maken

Als u geen pakketten meer wilt gebruiken uit de Ubuntu-.NET backports-pakketopslagplaats, kunt u de registratie ervan ongedaan maken. Open een terminal en voer de volgende opdracht uit:

sudo add-apt-repository --remove ppa:dotnet/backports

opdracht add-apt-repository is niet gevonden

Het add-apt-repository(1) hulpprogramma is vooraf geïnstalleerd op de meeste Ubuntu-installaties.

Als u een foutbericht krijgt dat de add-apt-repository opdracht niet is gevonden, moet u het software-properties-common pakket installeren, dat deze opdracht biedt. Open een terminal en voer de volgende opdrachten uit:

sudo apt update
sudo apt install software-properties-common

de Microsoft-pakketopslagplaats registreren

De Microsoft-pakketopslagplaats bevat alle versies van .NET die eerder waren of momenteel ondersteund met uw versie van Ubuntu. Als uw versie van Ubuntu .NET pakketten biedt, moet u de Ubuntu-pakketten deprioritiseren en de Microsoft-opslagplaats gebruiken. Zie Ik heb een versie van .NET nodig die niet door mijn Linux-distributie wordt geleverd voor instructies over hoe u de prioriteit van de pakketten kunt verlagen.

Preview-versies zijn niet beschikbaar in de Microsoft-pakketopslagplaats. Zie Preview-versies installeren voor meer informatie.

Installeren met APT kan worden uitgevoerd met een paar opdrachten. Voordat u .NET installeert, voert u de volgende opdrachten uit om de ondertekeningssleutel voor Microsoft-pakketten toe te voegen aan uw lijst met vertrouwde sleutels en de pakketopslagplaats toe te voegen.

Open een terminal en voer de volgende opdrachten uit:

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

# Download Microsoft signing key and repository
wget https://packages.microsoft.com/config/$ID/$VERSION_ID/packages-microsoft-prod.deb -O packages-microsoft-prod.deb

# Install Microsoft signing key and repository
sudo dpkg -i packages-microsoft-prod.deb

# Clean up
rm packages-microsoft-prod.deb

# Update packages
sudo apt update

.NET installeren, verwijderen of bijwerken

In de volgende secties wordt beschreven hoe u .NET beheert via pakketbeheer.

.NET installeren

Installeer .NET via pakketbeheer met de opdracht sudo apt install <package-name>. Vervang <package-name> door de naam van het .NET-pakket dat u wilt installeren. Als u bijvoorbeeld .NET SDK 10.0 wilt installeren, gebruikt u de opdracht sudo apt install dotnet-sdk-10.0. De volgende tabel bevat de momenteel ondersteunde .NET pakketten (die ight variëren per Ubuntu-versie):

Sommige omgevingsvariabelen zijn van invloed op hoe .NET wordt uitgevoerd nadat deze is geïnstalleerd. Zie .NET SDK- en CLI-omgevingsvariabelen voor meer informatie.

.NET verwijderen

Als u .NET hebt geïnstalleerd via pakketbeheer, verwijdert u deze op dezelfde manier met de opdracht apt-get remove:

sudo apt-get remove dotnet-sdk-6.0

Zie Uninstall .NET voor meer informatie.

.NET bijwerken

Als u .NET hebt geïnstalleerd via pakketbeheer, kunt u het pakket upgraden met de opdracht apt upgrade. Met de volgende opdrachten wordt het dotnet-sdk-10.0 pakket bijvoorbeeld bijgewerkt met de nieuwste versie:

sudo apt update
sudo apt upgrade dotnet-sdk-10.0

Preview-versies beheren

In de volgende secties wordt beschreven hoe u preview-versies van .NET installeert en verwijdert.

Preview-versies installeren

Preview- en release-kandidaatversies van .NET zijn niet beschikbaar in pakketopslagplaatsen. U kunt previews installeren en kandidaten voor .NET vrijgeven op een van de volgende manieren:

• Gescripte installatie met install-dotnet.sh
• Handmatige binaire extractie

Preview-versies verwijderen

Wanneer u een pakketbeheerder gebruikt om de installatie van .NET te beheren, kan er een conflict optreden als u eerder een preview-versie hebt geïnstalleerd. De pakketbeheerder kan de niet-preview-versie interpreteren als een eerdere versie van .NET. Als u de niet-preview-versie wilt installeren, moet u eerst de preview-versies verwijderen. Zie Het verwijderen van .NET Runtime en SDK voor meer informatie over het verwijderen van .NET.

Probleemoplossingsproces

Vanaf Ubuntu 22.04 ondervindt u mogelijk een situatie waarin het lijkt alsof er slechts een deel van .NET beschikbaar is. U hebt bijvoorbeeld de runtime en de SDK geïnstalleerd, maar wanneer u dotnet --info uitvoert, wordt alleen de runtime vermeld. Deze situatie kan betrekking hebben op het gebruik van twee verschillende pakketbronnen. De ingebouwde ubuntu 22.04- en Ubuntu 22.10-pakketfeeds bevatten enkele versies van .NET, maar niet alle, en mogelijk hebt u ook .NET van de Microsoft-feeds geïnstalleerd. Zie Troubleshoot .NET fouten met betrekking tot ontbrekende bestanden in Linux voor meer informatie over het oplossen van dit probleem.

APT-problemen

Deze sectie bevat informatie over veelvoorkomende fouten die kunnen optreden tijdens het gebruik van APT om .NET te installeren.

Kan pakket niet vinden

Zie een van de volgende artikelen voor meer informatie over het installeren van .NET without a package manager:

• Gebruik het script om .NET.
• Installeer .NET handmatig.

Kan bepaalde pakketten niet vinden \ Sommige pakketten konden niet worden geïnstalleerd

Als u een foutbericht krijgt dat lijkt op Kan pakket {dotnet-package} niet vinden of sommige pakketten niet kunnen worden geïnstalleerd, voert u de volgende opdrachten uit.

Er zijn twee plaatsaanduidingen in de volgende set commando's.

• {dotnet-package}
  Dit vertegenwoordigt het .NET-pakket dat u installeert, zoals aspnetcore-runtime-8.0. Dit wordt gebruikt in de volgende sudo apt-get install opdracht.

Verwijder eerst de pakketlijst:

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

Probeer vervolgens .NET opnieuw te installeren. Als dat niet werkt, kunt u een handmatige installatie uitvoeren met de volgende opdrachten:

Als u Ubuntu 23.10 of hoger gebruikt, kunt u de volgende opdrachten proberen:

# 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}

Als u een Ubuntu-versie gebruikt vóór 23.10, probeer de volgende opdrachten:

# 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}

Ophalen is mislukt

Tijdens het installeren van het .NET-pakket ziet u mogelijk een fout die vergelijkbaar is met Failed to fetch ... File has unexpected size ... Mirror sync in progress?. Deze fout kan betekenen dat de pakketfeed voor .NET wordt bijgewerkt met nieuwere pakketversies en dat u het later opnieuw moet proberen. Tijdens een upgrade mag de pakketfeed langer dan 30 minuten niet beschikbaar zijn. Als u deze fout gedurende meer dan 30 minuten voortdurend ontvangt, kunt u een probleem indienen bij https://github.com/dotnet/core/issues.

Afhankelijkheden

Wanneer u installeert met pakketbeheer, worden deze bibliotheken voor u geïnstalleerd. Als u echter handmatig .NET installeert of als u een zelfstandige app publiceert, moet u deze afhankelijkheden installeren om uw app uit te voeren:

• CA-certificaten
• libc6
• libgcc1 (voor 16.x en 18.x)
• libgcc-s1 (voor 20.x of hoger)
• libgssapi-krb5-2
• libicu55 (voor 16.x)
• libicu60 (voor 18.x)
• libicu66 (voor 20.x)
• libicu70 (voor 22.04)
• libicu72 (voor 23.10)
• libicu74 (voor 24.04)
• libicu76 (voor 25.04 of hoger)
• libssl1.0.0 (voor 16.x)
• libssl1.1 (voor 18.x, 20.x)
• libssl3 (voor 22.x of hoger)
• libstdc++6
• tzdata
• zlib1g

Afhankelijkheden kunnen worden geïnstalleerd met de apt install opdracht. In het volgende fragment ziet u hoe u de zlib1g bibliotheek installeert:

sudo apt install zlib1g

Volgende stappen

• overzicht van .NET CLI
• Het inschakelen van tabvoltooiing voor de .NET CLI
• Tutorial: Een consoletoepassing maken met .NET