Installieren von .NET SDK oder .NET Runtime unter Ubuntu

In diesem Artikel wird beschrieben, wie Sie .NET unter Ubuntu installieren.

Installieren Sie das SDK (das die Runtime enthält), wenn Sie .NET Core-Apps entwickeln möchten. Wenn Sie Apps nur ausführen möchten, installieren Sie die Runtime. Wenn Sie die Runtime installieren, wird die Installation der ASP.NET Core-Runtime empfohlen, da diese sowohl .NET- als auch ASP.NET Core-Runtimes umfasst.

Überprüfen Sie mithilfe der Befehle dotnet --list-sdks und dotnet --list-runtimes, welche Versionen installiert sind. Weitere Informationen finden Sie unter Überprüfen, ob .NET Core bereits installiert ist.

Wichtig

Bei Verwendung eines Paket-Managers zum Installieren von .NET aus dem Microsoft-Paketfeed wird nur die x64-Architektur unterstützt. Andere Architekturen, z. B. Arm, werden vom Microsoft-Paketfeed nicht unterstützt. Verwenden Sie die Ubuntu-Feeds, oder installieren Sie .NET manuell. Seien Sie vorsichtig, wenn Sie mehrere Feeds verwenden, da es sonst zu Paketverwechslungen kommen kann. Weitere Informationen finden Sie unter .NET-Paketverwechslungen unter Linux.

Weitere Informationen zur Installation von .NET ohne Paket-Manager finden Sie in einem der folgenden Artikel:

Ubuntu 24.10

.NET ist in den Ubuntu-Paket-Manager-Feeds verfügbar. Das Microsoft-Paket-Repository enthält keine .NET-Pakete für Ubuntu mehr.

Die folgenden Versionen von .NET werden unterstützt oder für Ubuntu 24.10 verfügbar:

  • 9.0
  • 8.0

Wenn für eine Ubuntu-Version kein Support mehr geboten wird, wird .NET mit dieser Version nicht mehr unterstützt.

Wichtig

.NET 9 wurde am 12. November 2024 veröffentlicht. Es kann Zeit dauern, bis die Pakete in den Paket-Manager-Feeds oder für Ihre spezifische Linux-Verteilung angezeigt werden, um sie einzuschließen.

Installieren des SDKs

Das .NET SDK ermöglicht Ihnen die Entwicklung von Apps mit .NET. Wenn Sie das .NET SDK installieren, müssen Sie die entsprechende Runtime nicht installieren. Führen Sie die folgenden Befehle aus, um das .NET SDK zu installieren:

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

Informationen zur Verwendung der .NET CLI finden Sie in der .NET CLI-Übersicht.

Installieren der Runtime

Die ASP.NET Core-Runtime ermöglicht Ihnen die Ausführung von Apps, die mit .NET erstellt wurden und die Runtime nicht enthalten. Durch die folgenden Befehle wird die ASP.NET Core-Runtime installiert, d. h. die Runtime für .NET mit der höchsten Kompatibilität. Führen Sie in Ihrem Terminal die folgenden Befehle aus:

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

Als Alternative zur ASP.NET Core-Runtime können Sie die .NET-Runtime installieren, die keine ASP.NET Core-Unterstützung bietet: Ersetzen Sie dazu im vorangegangenen Befehl aspnetcore-runtime-9.0 durch dotnet-runtime-9.0:

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

Informationen zur Verwendung der .NET CLI finden Sie in der .NET CLI-Übersicht.

Abhängigkeiten

Wenn die Installation mit einem Paket-Manager erfolgt, werden diese Bibliotheken für Sie installiert. Wenn Sie jedoch .NET manuell installieren oder eine eigenständige Anwendung veröffentlichen, müssen Sie sicherstellen, dass diese Bibliotheken installiert sind:

  • ca-certificates
  • libc6
  • libgcc-s1
  • libicu74
  • liblttng-ust1
  • libssl3
  • libstdc++6
  • libunwind8
  • zlib1g

Abhängigkeiten können mit dem Befehl apt install installiert werden Der folgende Codeschnipsel veranschaulicht die Installation der zlib1g-Bibliothek:

sudo apt install zlib1g

Wenn die .NET-App die System.Drawing.Common-Assembly verwendet, muss libgdiplus installiert werden. Weitere Informationen finden Sie unter "System.Drawing.Common", das nur unter Windows unterstützt wird.

Sie können eine neuere Version von libgdiplus installieren, indem Sie Ihrem System das Mono-Repository hinzufügen.

Ubuntu 24.04

.NET ist in den Feeds des Ubuntu-Paket-Managers sowie im Microsoft-Paketrepository verfügbar. Sie sollten jedoch nur die eine oder andere Variante verwenden, um .NET zu installieren. Microsoft empfiehlt, die Feeds des Ubuntu-Paket-Managers zu verwenden. Wenn Sie das Microsoft-Paketrepository verwenden möchten, finden Sie weitere Informationen unter Registrieren des Microsoft-Paketrepositorys.

Die folgenden Versionen von .NET werden unterstützt oder sind für Ubuntu 24.04 verfügbar:

Unterstützte .NET-Versionen Verfügbar in
Integrierter Ubuntu-Feed
Verfügbar in
backports
Ubuntu-Feed
Verfügbar in
Microsoft-Feed
9.0, 8.0 8.0 7.0, 6.0 Keine

Wenn für eine Ubuntu-Version kein Support mehr geboten wird, wird .NET mit dieser Version nicht mehr unterstützt.

Wichtig

.NET 9 wurde am 12. November 2024 veröffentlicht. Es kann Zeit dauern, bis die Pakete in den Paket-Manager-Feeds oder für Ihre spezifische Linux-Verteilung angezeigt werden, um sie einzuschließen.

Nicht von Microsoft veröffentlicht.

Abhängigkeiten

Wenn die Installation mit einem Paket-Manager erfolgt, werden diese Bibliotheken für Sie installiert. Wenn Sie jedoch .NET manuell installieren oder eine eigenständige Anwendung veröffentlichen, müssen Sie sicherstellen, dass diese Bibliotheken installiert sind:

  • ca-certificates
  • libc6
  • libgcc-s1
  • libicu74
  • liblttng-ust1
  • libssl3
  • libstdc++6
  • libunwind8
  • zlib1g

Abhängigkeiten können mit dem Befehl apt install installiert werden Der folgende Codeschnipsel veranschaulicht die Installation der zlib1g-Bibliothek:

sudo apt install zlib1g

Wenn die .NET-App die System.Drawing.Common-Assembly verwendet, muss libgdiplus installiert werden. Weitere Informationen finden Sie unter "System.Drawing.Common", das nur unter Windows unterstützt wird.

Sie können eine neuere Version von libgdiplus installieren, indem Sie Ihrem System das Mono-Repository hinzufügen.

Ubuntu 22.04

.NET ist in den Feeds des Ubuntu-Paket-Managers sowie im Microsoft-Paketrepository verfügbar. Sie sollten jedoch nur die eine oder andere Variante verwenden, um .NET zu installieren. Microsoft empfiehlt, die Feeds des Ubuntu-Paket-Managers zu verwenden. Wenn Sie das Microsoft-Paketrepository verwenden möchten, finden Sie weitere Informationen unter Registrieren des Microsoft-Paketrepositorys.

Die folgenden Versionen von .NET werden unterstützt oder sind für Ubuntu 22.04 verfügbar:

Unterstützte .NET-Versionen Verfügbar in
Integrierter Ubuntu-Feed
Verfügbar in
.NET-Backports
Ubuntu-Feed
Verfügbar in
Microsoft-Feed
9.0, 8.0 8.0, 7.0, 6.0 Keine 8.0, 7.0, 6.0, 3.1

Wichtig

Wenn Sie .NET 8 SDK und Ubuntu 22.04 verwenden, sollten Sie wissen, dass die von Canonical angebotenen SDK-Versionen immer in der .1xx-Featureband enthalten sind. Wenn Sie ein neueres Featurebandrelease verwenden möchten, verwenden Sie den Microsoft-Feed, um das SDK zu installieren. Lesen Sie sich unbedingt die Informationen im Artikel .NET-Paketvertauschungen auf Linux durch, um die Auswirkungen des Wechsels zwischen Repositoryfeeds zu verstehen.

Wenn für eine Ubuntu-Version kein Support mehr geboten wird, wird .NET mit dieser Version nicht mehr unterstützt.

Wichtig

.NET 9 wurde am 12. November 2024 veröffentlicht. Es kann Zeit dauern, bis die Pakete in den Paket-Manager-Feeds oder für Ihre spezifische Linux-Verteilung angezeigt werden, um sie einzuschließen.

Nicht von Microsoft veröffentlicht.

Abhängigkeiten

Wenn die Installation mit einem Paket-Manager erfolgt, werden diese Bibliotheken für Sie installiert. Wenn Sie jedoch .NET manuell installieren oder eine eigenständige Anwendung veröffentlichen, müssen Sie sicherstellen, dass diese Bibliotheken installiert sind:

  • ca-certificates
  • libc6
  • libgcc-s1
  • libgssapi-krb5-2
  • libicu70
  • liblttng-ust1
  • libssl3
  • libstdc++6
  • libunwind8
  • zlib1g

Abhängigkeiten können mit dem Befehl apt install installiert werden Der folgende Codeschnipsel veranschaulicht die Installation der zlib1g-Bibliothek:

sudo apt install zlib1g

Wenn die .NET-App die System.Drawing.Common-Assembly verwendet, muss libgdiplus installiert werden. Weitere Informationen finden Sie unter "System.Drawing.Common", das nur unter Windows unterstützt wird.

Sie können eine neuere Version von libgdiplus installieren, indem Sie Ihrem System das Mono-Repository hinzufügen.

Ubuntu 20.04

Das standardmäßige Ubuntu-Paket-Repository enthält diese Version von .NET nicht. Verwenden Sie stattdessen das Microsoft-Paket-Repository.

Die folgenden Versionen von .NET werden unterstützt oder sind für Ubuntu 20.04 verfügbar:

Unterstützte .NET-Versionen Verfügbar in
Integrierter Ubuntu-Feed
Verfügbar in
.NET-Backports
Ubuntu-Feed
Verfügbar in
Microsoft-Feed
8.0 Keine Keine 8.0, 7.0. 6.0, 5.0, 3.1, 2.1

Wenn für eine Ubuntu-Version kein Support mehr geboten wird, wird .NET mit dieser Version nicht mehr unterstützt.

Fügen Sie das Microsoft-Paketrepository hinzu.

Die Installation mit APT kann mit einigen wenigen Befehlen erfolgen. Bevor Sie .NET installieren, führen Sie die folgenden Befehle aus, um den Microsoft-Paketsignaturschlüssel zu Ihrer Liste vertrauenswürdiger Schlüssel und das Paketrepository hinzuzufügen.

Öffnen Sie ein Terminal, und führen Sie die folgenden Befehle aus:

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

Da Ubuntu 20.04 das Ende der Lebensdauer im April 2025 erreicht, hat Microsoft beschlossen, .NET 9 auf Ubuntu 20.04 nicht zu unterstützen.

Abhängigkeiten

Wenn die Installation mit einem Paket-Manager erfolgt, werden diese Bibliotheken für Sie installiert. Wenn Sie jedoch .NET manuell installieren oder eine eigenständige Anwendung veröffentlichen, müssen Sie sicherstellen, dass diese Bibliotheken installiert sind:

  • ca-certificates
  • libc6
  • libgcc-s1
  • libgssapi-krb5-2
  • libicu66
  • libssl1.1
  • libstdc++6
  • zlib1g

Abhängigkeiten können mit dem Befehl apt install installiert werden Der folgende Codeschnipsel veranschaulicht die Installation der zlib1g-Bibliothek:

sudo apt install zlib1g

Wenn die .NET-App die System.Drawing.Common-Assembly verwendet, muss libgdiplus installiert werden. Weitere Informationen finden Sie unter "System.Drawing.Common", das nur unter Windows unterstützt wird.

Sie können eine neuere Version von libgdiplus installieren, indem Sie Ihrem System das Mono-Repository hinzufügen.

Nicht unterstützte Versionen

Die folgenden Versionen von .NET ❌ werden nicht mehr unterstützt:

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

Installieren anderer Versionen

Die Namen der .NET-Pakete sind in allen Linux-Distributionen standardisiert. In der folgenden Tabelle sind die Pakete aufgeführt:

Alle Versionen von .NET stehen unter https://dotnet.microsoft.com/download/dotnet zum Download zur Verfügung, erfordern jedoch manuelle Installation. Sie können versuchen, den Paket-Manager zu verwenden, um eine andere Version von .NET zu installieren. Die angeforderte Version ist jedoch möglicherweise nicht verfügbar.

Die Pakete, die Paket-Manager-Feeds hinzugefügt werden, werden in einem Format benannt, das gehackt werden kann: {product}-{type}-{version}.

  • product
    Der Typ des zu installierenden .NET-Produkts. Folgende Optionen sind gültig:

    • dotnet
    • aspnetcore
  • type
    Wählt das SDK oder die Runtime aus. Folgende Optionen sind gültig:

    • sdk(nur für das dotnet-Produkt verfügbar)
    • runtime
  • Version
    Die Version des zu installierenden SDK oder der zu installierenden Runtime. Gültige Optionen sind alle veröffentlichte Versionen, wie z. B.:

    • 9.0
    • 8.0
    • 3.1
    • 2.1

    Es ist möglich, dass das SDK bzw. die Runtime, das/die Sie herunterladen möchten, für Ihre Linux-Distribution nicht verfügbar ist. Eine Liste der unterstützten Distributionen finden Sie unter Installieren von .NET unter Linux.

Beispiele

  • Installieren Sie die ASP.NET Core 9.0-Laufzeit: aspnetcore-runtime-9.0
  • Installieren der .NET Core 2.1-Runtime: dotnet-runtime-2.1
  • Installieren des .NET 5 SDK: dotnet-sdk-5.0
  • Installieren des .NET Core 3.1 SDK: dotnet-sdk-3.1

Hinweis

Einige Pakete sind möglicherweise nicht in Ihrer Linux-Distribution verfügbar.

Fehlendes Paket

Wenn die Kombination aus Paket und Version nicht funktioniert, ist sie nicht verfügbar. Es gibt z. B. kein ASP.NET Core SDK. Die SDK-Komponenten für ASP.NET Core sind im .NET SDK enthalten. Der Wert aspnetcore-sdk-8.0 ist falsch und sollte dotnet-sdk-8.0 lauten. Eine Liste der von .NET unterstützten Linux-Distributionen finden Sie unter .NET-Abhängigkeiten und -Anforderungen.

Manuelle Installation

Wenn Ihre Ubuntu-Version nicht unterstützt wird, müssen Sie wahrscheinlich .NET installieren, indem Sie die Binärdateien manuell extrahieren, indem Sie das Installationsskript verwenden. Weitere Informationen finden Sie unter Installieren von .NET unter Linux ohne Verwendung eines Paket-Managers.

Ubuntu 23.10

Warnung

Diese Version von Ubuntu wird nicht mehr unterstützt.

Das Ausführen von .NET auf dieser Version von Ubuntu wird nicht mehr unterstützt.

.NET ist in den Feeds des Ubuntu-Paket-Managers sowie im Microsoft-Paketrepository verfügbar. Sie sollten jedoch nur die eine oder andere Variante verwenden, um .NET zu installieren. Microsoft empfiehlt, die Feeds des Ubuntu-Paket-Managers zu verwenden. Wenn Sie das Microsoft-Paketrepository verwenden möchten, finden Sie weitere Informationen unter Registrieren des Microsoft-Paketrepositorys.

Die folgenden Versionen von .NET wurden unterstützt oder für Ubuntu 23.10 verfügbar:

Unterstützte .NET-Versionen Verfügbar in
Integrierter Ubuntu-Feed
Verfügbar in
.NET-Backports
Ubuntu-Feed
Verfügbar in
Microsoft-Feed
8.0, 6.0 8.0, 7.0, 6.0 Keine 8.0, 7.0, 6.0

Wichtig

Wenn Sie .NET 8 SDK und Ubuntu 22.04 verwenden, sollten Sie wissen, dass die von Canonical angebotenen SDK-Versionen immer in der .1xx-Featureband enthalten sind. Wenn Sie ein neueres Featurebandrelease verwenden möchten, verwenden Sie den Microsoft-Feed, um das SDK zu installieren. Lesen Sie sich unbedingt die Informationen im Artikel .NET-Paketvertauschungen auf Linux durch, um die Auswirkungen des Wechsels zwischen Repositoryfeeds zu verstehen.

Wenn für eine Ubuntu-Version kein Support mehr geboten wird, wird .NET mit dieser Version nicht mehr unterstützt.

.NET 9 wird unter Ubuntu 23.10 nicht unterstützt.

Abhängigkeiten

Wenn die Installation mit einem Paket-Manager erfolgt, werden diese Bibliotheken für Sie installiert. Wenn Sie jedoch .NET manuell installieren oder eine eigenständige Anwendung veröffentlichen, müssen Sie sicherstellen, dass diese Bibliotheken installiert sind:

  • ca-certificates
  • libc6
  • libgcc-s1
  • libgssapi-krb5-2
  • libicu72
  • liblttng-ust1
  • libssl3
  • libstdc++6
  • libunwind8
  • zlib1g

Abhängigkeiten können mit dem Befehl apt install installiert werden Der folgende Codeschnipsel veranschaulicht die Installation der zlib1g-Bibliothek:

sudo apt install zlib1g

Wenn die .NET-App die System.Drawing.Common-Assembly verwendet, muss libgdiplus installiert werden. Weitere Informationen finden Sie unter "System.Drawing.Common", das nur unter Windows unterstützt wird.

Sie können eine neuere Version von libgdiplus installieren, indem Sie Ihrem System das Mono-Repository hinzufügen.

Ubuntu 23.04

Warnung

Diese Version von Ubuntu wird nicht mehr unterstützt.

Das Ausführen von .NET auf dieser Version von Ubuntu wird nicht mehr unterstützt.

.NET ist in den Feeds des Ubuntu-Paket-Managers sowie im Microsoft-Paketrepository verfügbar. Sie sollten jedoch nur die eine oder andere Variante verwenden, um .NET zu installieren. Microsoft empfiehlt, die Feeds des Ubuntu-Paket-Managers zu verwenden. Wenn Sie das Microsoft-Paketrepository verwenden möchten, finden Sie weitere Informationen unter Registrieren des Microsoft-Paketrepositorys.

Die folgenden Versionen von .NET wurden unterstützt oder für Ubuntu 23.04 verfügbar:

Unterstützte .NET-Versionen Verfügbar in
Integrierter Ubuntu-Feed
Verfügbar in
.NET-Backports
Ubuntu-Feed
Verfügbar in
Microsoft-Feed
8.0, 6.0 7.0, 6.0 Keine 8.0, 7.0, 6.0

Wichtig

Wenn Sie .NET 8 SDK und Ubuntu 22.04 verwenden, sollten Sie wissen, dass die von Canonical angebotenen SDK-Versionen immer in der .1xx-Featureband enthalten sind. Wenn Sie ein neueres Featurebandrelease verwenden möchten, verwenden Sie den Microsoft-Feed, um das SDK zu installieren. Lesen Sie sich unbedingt die Informationen im Artikel .NET-Paketvertauschungen auf Linux durch, um die Auswirkungen des Wechsels zwischen Repositoryfeeds zu verstehen.

.NET 9 wird unter Ubuntu 23.04 nicht unterstützt.

Abhängigkeiten

Wenn die Installation mit einem Paket-Manager erfolgt, werden diese Bibliotheken für Sie installiert. Wenn Sie jedoch .NET manuell installieren oder eine eigenständige Anwendung veröffentlichen, müssen Sie sicherstellen, dass diese Bibliotheken installiert sind:

  • ca-certificates
  • libc6
  • libgcc-s1
  • libgssapi-krb5-2
  • libicu72
  • liblttng-ust1
  • libssl3
  • libstdc++6
  • libunwind8
  • zlib1g

Abhängigkeiten können mit dem Befehl apt install installiert werden Der folgende Codeschnipsel veranschaulicht die Installation der zlib1g-Bibliothek:

sudo apt install zlib1g

Wenn die .NET-App die System.Drawing.Common-Assembly verwendet, muss libgdiplus installiert werden. Weitere Informationen finden Sie unter "System.Drawing.Common", das nur unter Windows unterstützt wird.

Sie können eine neuere Version von libgdiplus installieren, indem Sie Ihrem System das Mono-Repository hinzufügen.

Ubuntu 22.10

Warnung

Diese Version von Ubuntu wird nicht mehr unterstützt.

Das Ausführen von .NET auf dieser Version von Ubuntu wird nicht mehr unterstützt.

.NET ist in den Feeds des Ubuntu-Paket-Managers sowie im Microsoft-Paketrepository verfügbar. Sie sollten jedoch nur die eine oder andere Variante verwenden, um .NET zu installieren. Microsoft empfiehlt, die Feeds des Ubuntu-Paket-Managers zu verwenden. Wenn Sie das Microsoft-Paketrepository verwenden möchten, finden Sie weitere Informationen unter Registrieren des Microsoft-Paketrepositorys.

Die folgenden Versionen von .NET werden unterstützt oder sind für Ubuntu 22.10 verfügbar:

Unterstützte .NET-Versionen Verfügbar in
Integrierter Ubuntu-Feed
Verfügbar in
.NET-Backports
Ubuntu-Feed
Verfügbar in
Microsoft-Feed
6.0 7.0, 6.0 Keine 7.0, 6.0, 3.1

Wichtig

Wenn Sie .NET 8 SDK und Ubuntu 22.04 verwenden, sollten Sie wissen, dass die von Canonical angebotenen SDK-Versionen immer in der .1xx-Featureband enthalten sind. Wenn Sie ein neueres Featurebandrelease verwenden möchten, verwenden Sie den Microsoft-Feed, um das SDK zu installieren. Lesen Sie sich unbedingt die Informationen im Artikel .NET-Paketvertauschungen auf Linux durch, um die Auswirkungen des Wechsels zwischen Repositoryfeeds zu verstehen.

.NET 9 wird unter Ubuntu 22.10 nicht unterstützt.

Abhängigkeiten

Wenn die Installation mit einem Paket-Manager erfolgt, werden diese Bibliotheken für Sie installiert. Wenn Sie jedoch .NET manuell installieren oder eine eigenständige Anwendung veröffentlichen, müssen Sie sicherstellen, dass diese Bibliotheken installiert sind:

  • ca-certificates
  • libc6
  • libgcc-s1
  • libgssapi-krb5-2
  • libicu71
  • liblttng-ust1
  • libssl3
  • libstdc++6
  • libunwind8
  • zlib1g

Abhängigkeiten können mit dem Befehl apt install installiert werden Der folgende Codeschnipsel veranschaulicht die Installation der zlib1g-Bibliothek:

sudo apt install zlib1g

Wenn die .NET-App die System.Drawing.Common-Assembly verwendet, muss libgdiplus installiert werden. Weitere Informationen finden Sie unter "System.Drawing.Common", das nur unter Windows unterstützt wird.

Sie können eine neuere Version von libgdiplus installieren, indem Sie Ihrem System das Mono-Repository hinzufügen.

Nächste Schritte