About this Install Guide

This guide is intended to get you up and running with this tool quickly with the most common settings. For a thorough review of all options, refer to the official documentation.

The .NET SDK is a free, open-source, and cross-platform development environment that provides a broad set of tools and libraries for building applications. You can use it to create a variety of applications including web apps, mobile apps, desktop apps, and cloud services.

The .NET SDK is available for Linux distributions on Arm-based systems.

What should I do before installing the .NET SDK on Arm Linux?

Confirm you are using an Arm machine by running:

    

        
        
            uname -m
        
    

The output should be:

    

        
        aarch64

        
    

If you see a different result, you are not using an Arm computer running 64-bit Linux.

How do I install the .NET SDK on my Arm Linux system?

There are two ways to install the .NET SDK on your computer:

  • Using the Linux package manager.
  • Using the install script.

Select the one that works best for you.

How can I install .NET SDK using the Linux package manager?

Use apt to install .NET SDK on Ubuntu and Debian:

    

        
        
            sudo apt-get install -y dotnet-sdk-8.0
        
    

Use dnf to install .NET SDK on Fedora:

    

        
        
            sudo dnf install dotnet-sdk-8.0
        
    

If the .NET SDK is not found in your package manager, you can install it using a script.

How can I install .NET SDK using a script?

To install the .NET SDK using a script, follow the instructions below:

  1. Download the install script:
    

        
        
            wget https://dot.net/v1/dotnet-install.sh
        
    
  1. Run the script (it will install .NET SDK 8 under the folder .dotnet):

You have some options to specify the version you want to install.

To install the latest long term support (LTS) version, run:

    

        
        
            bash ./dotnet-install.sh
        
    

To install the latest version, run:

    

        
        
            bash ./dotnet-install.sh --version latest
        
    

To install a specific version, run:

    

        
        
            bash ./dotnet-install.sh --channel 8.0
        
    
  1. Add the .dotnet folder to the PATH environment variable:
    

        
        
            export PATH="$HOME/.dotnet/:$PATH"
        
    

You can also add the search path to your $HOME/.bashrc so it is set for all new shells.

How do I verify the .NET SDK installation?

To check that the installation was successful, type:

    

        
        
            dotnet --list-sdks
        
    

The output is printed:

    

        
        8.0.105 [/usr/lib/dotnet/sdk]

        
    

To print more information, run the following command:

    

        
        
            dotnet --info
        
    

More details about your installation are printed:

    

        
        .NET SDK:
 Version:           8.0.105
 Commit:            eae90abaaf
 Workload version:  8.0.100-manifests.796a77f8

Runtime Environment:
 OS Name:     ubuntu
 OS Version:  24.04
 OS Platform: Linux
 RID:         ubuntu.24.04-arm64
 Base Path:   /usr/lib/dotnet/sdk/8.0.105/

.NET workloads installed:
 Workload version: 8.0.100-manifests.796a77f8
There are no installed workloads to display.

Host:
  Version:      8.0.5
  Architecture: arm64
  Commit:       087e15321b

.NET SDKs installed:
  8.0.105 [/usr/lib/dotnet/sdk]

.NET runtimes installed:
  Microsoft.AspNetCore.App 8.0.5 [/usr/lib/dotnet/shared/Microsoft.AspNetCore.App]
  Microsoft.NETCore.App 8.0.5 [/usr/lib/dotnet/shared/Microsoft.NETCore.App]

Other architectures found:
  None

Environment variables:
  Not set

global.json file:
  Not found

Learn more:
  https://aka.ms/dotnet/info

Download .NET:
  https://aka.ms/dotnet/download

        
    

How can I run a simple example to confirm the .NET SDK is working?

To test the .NET SDK installation, create a new hello world console application:

    

        
        
            dotnet new console -o myapp
        
    

Change to the new directory and run:

    

        
        
            cd myapp
dotnet run
        
    

The expected output in the console is:

    

        
        Hello World!

        
    

You are ready to use the .NET SDK on Arm Linux.

You can find more information about .NET on Arm in the AWS Graviton Technical Guide .

Explore .NET examples by visiting the Learning Center .


Feedback

How would you rate the overall quality of this tool quick-install guide?