Get started with .NET in 10 minutes

Not ready to install anything? Try our in-browser tutorial.

Tutorial Guide

Windows

Linux

macOS

Try .NET In Your Browser

Download and Install

To start building .NET apps you just need to download and install the .NET SDK (Software Development Kit) for Windows.

Download .NET SDK

Video: Creating a Simple .NET Application on Windows
Create your app

Open a new command prompt and run the following commands.
```
dotnet new console -o myApp
cd myApp
```
The dotnet command will create a new application of type console for you. The -o parameter will create a directory named myApp where your app will be stored, and populates it with the required files. The cd myApp command puts you into the newly created app directory.

The main file in the myApp folder is Program.cs. By default, it already contains the necessary code to write "Hello World!" to the Console.
```
using System;

namespace myApp
{
    class Program
    {
        static void Main(string[] args)
        {
            Console.WriteLine("Hello World!");
        }
    }
}
```
Run your app

In your command prompt, run the following command:
```
dotnet run
```
Congratulations, you've built and run your first .NET app!
Get an editor

Visual Studio is a fully-featured integrated development environment (IDE) for developing .NET apps on Windows.

Download Visual Studio

Select the .NET Core cross-platform development workload during installation:
Keep learning

While you wait for Visual Studio to install, you can keep learning with the .NET Quick Starts. In the first Quick Start you'll learn about collections.

Quick start: Collections

Once Visual Studio is installed, come back and build your first .NET app using Visual Studio.

Enable the .NET channel for Red Hat Enterprise Linux 7

In order to install .NET Core from Red Hat on RHEL, you first need to register using the Red Hat Subscription Manager. If this has not been done on your system, or if you are unsure, see the Red Hat Getting Started Guide.
Install and enable the .NET SDK

After registering with the Subscription Manager and enabling the .NET Core channel, you are ready to install and enable the .NET SDK.

In your command prompt, run the following commands:
```
yum install rh-dotnet20 -y
scl enable rh-dotnet20 bash
```
Create your app

Open a new command prompt and run the following commands.
```
dotnet new console -o myApp
cd myApp
```
The dotnet command will create a new application of type console for you. The -o parameter will create a directory named myApp where your app will be stored, and populates it with the required files. The cd myApp command puts you into the newly created app directory.

The main file in the myApp folder is Program.cs. By default, it already contains the necessary code to write "Hello World!" to the Console.
```
using System;

namespace myApp
{
    class Program
    {
        static void Main(string[] args)
        {
            Console.WriteLine("Hello World!");
        }
    }
}
```
Run your app

In your command prompt, run the following command:
```
dotnet run
```
Congratulations, you've built and run your first .NET app!
Get an editor

Visual Studio Code is a free, cross-platform code editor with support for .NET.

Download Visual Studio Code

For full language support including smart code completion and debugging, get the C# extension for Visual Studio Code.

Download the C# Extension

There are also third party tools for developing .NET apps. JetBrains Rider is a cross-platform .NET IDE built using IntelliJ and ReSharper technology.
Keep learning

Now that you've got the basics, you can keep learning with the .NET Quick Starts. In the first Quick Start you'll learn about collections.

Quick start: Collections

Add the dotnet product feed

To start installing .NET, you'll need to register the Microsoft signature key and add the Microsoft Product feed. This only needs to be done once per machine.

Open a command prompt and run the following commands:

A video frame showing a Linux command prompt. Select this image to start playing the video.

Video: Creating a Simple .NET Application on Linux Ubuntu

Register the trusted Microsoft signature key:

curl https://packages.microsoft.com/keys/microsoft.asc | gpg --dearmor > microsoft.gpg
sudo mv microsoft.gpg /etc/apt/trusted.gpg.d/microsoft.gpg

Register the Microsoft Product feed

Ubuntu 17.10

sudo sh -c 'echo "deb [arch=amd64] https://packages.microsoft.com/repos/microsoft-ubuntu-artful-prod artful main" > /etc/apt/sources.list.d/dotnetdev.list'

Ubuntu 17.04

sudo sh -c 'echo "deb [arch=amd64] https://packages.microsoft.com/repos/microsoft-ubuntu-zesty-prod zesty main" > /etc/apt/sources.list.d/dotnetdev.list'

Ubuntu 16.04 / Linux Mint 18

sudo sh -c 'echo "deb [arch=amd64] https://packages.microsoft.com/repos/microsoft-ubuntu-xenial-prod xenial main" > /etc/apt/sources.list.d/dotnetdev.list'

Ubuntu 14.04 / Linux Mint 17

sudo sh -c 'echo "deb [arch=amd64] https://packages.microsoft.com/repos/microsoft-ubuntu-trusty-prod trusty main" > /etc/apt/sources.list.d/dotnetdev.list'

Install .NET SDK

Update the products available for installation, then install the .NET SDK.

In your command prompt, run the following commands:
```
sudo apt-get update
sudo apt-get install dotnet-sdk-2.0.2
```
Create your app

Open a new command prompt and run the following commands.
```
dotnet new console -o myApp
cd myApp
```
The dotnet command will create a new application of type console for you. The -o parameter will create a directory named myApp where your app will be stored, and populates it with the required files. The cd myApp command puts you into the newly created app directory.

The main file in the myApp folder is Program.cs. By default, it already contains the necessary code to write "Hello World!" to the Console.
```
using System;

namespace myApp
{
    class Program
    {
        static void Main(string[] args)
        {
            Console.WriteLine("Hello World!");
        }
    }
}
```
Run your app

In your command prompt, run the following command:
```
dotnet run
```
Congratulations, you've built and run your first .NET app!
Get an editor

Visual Studio Code is a free, cross-platform code editor with support for .NET.

Download Visual Studio Code

For full language support including smart code completion and debugging, get the C# extension for Visual Studio Code.

Download the C# Extension

There are also third party tools for developing .NET apps. JetBrains Rider is a cross-platform .NET IDE built using IntelliJ and ReSharper technology.
Keep learning

Now that you've got the basics, you can keep learning with the .NET Quick Starts. In the first Quick Start you'll learn about collections.

Quick start: Collections

Add the dotnet product feed

To start installing .NET, you'll need to install a few system components, register the Microsoft signature key, and add the Microsoft Product feed. This only needs to be done once per machine.

Open a command prompt and run the following commands:

Install system components

sudo apt-get update
sudo apt-get install curl libunwind8 gettext apt-transport-https

Register the trusted Microsoft Product key

curl https://packages.microsoft.com/keys/microsoft.asc | gpg --dearmor > microsoft.gpg
sudo mv microsoft.gpg /etc/apt/trusted.gpg.d/microsoft.gpg

Register the Microsoft Product feed

Debian 9 (Stretch)

sudo sh -c 'echo "deb [arch=amd64] https://packages.microsoft.com/repos/microsoft-debian-stretch-prod stretch main" > /etc/apt/sources.list.d/dotnetdev.list'

Debian 8 (Jessie)

sudo sh -c 'echo "deb [arch=amd64] https://packages.microsoft.com/repos/microsoft-debian-jessie-prod jessie main" > /etc/apt/sources.list.d/dotnetdev.list'

Install .NET SDK

Update the products available for installation, then install the .NET SDK.

In your command prompt, run the following commands:
```
sudo apt-get update
sudo apt-get install dotnet-sdk-2.0.2
```
Create your app

Open a new command prompt and run the following commands.
```
dotnet new console -o myApp
cd myApp
```
The dotnet command will create a new application of type console for you. The -o parameter will create a directory named myApp where your app will be stored, and populates it with the required files. The cd myApp command puts you into the newly created app directory.

The main file in the myApp folder is Program.cs. By default, it already contains the necessary code to write "Hello World!" to the Console.
```
using System;

namespace myApp
{
    class Program
    {
        static void Main(string[] args)
        {
            Console.WriteLine("Hello World!");
        }
    }
}
```
Run your app

In your command prompt, run the following command:
```
dotnet run
```
Congratulations, you've built and run your first .NET app!
Get an editor

Visual Studio Code is a free, cross-platform code editor with support for .NET.

Download Visual Studio Code

For full language support including smart code completion and debugging, get the C# extension for Visual Studio Code.

Download the C# Extension

There are also third party tools for developing .NET apps. JetBrains Rider is a cross-platform .NET IDE built using IntelliJ and ReSharper technology.
Keep learning

Now that you've got the basics, you can keep learning with the .NET Quick Starts. In the first Quick Start you'll learn about collections.

Quick start: Collections

Add the dotnet product feed

To start installing .NET, you'll need to register the Microsoft signature key and add the Microsoft Product feed. This only needs to be done once per machine.

Open a command prompt and run the following commands:

sudo rpm --import https://packages.microsoft.com/keys/microsoft.asc
sudo sh -c 'echo -e "[packages-microsoft-com-prod]\nname=packages-microsoft-com-prod \nbaseurl=https://packages.microsoft.com/yumrepos/microsoft-rhel7.3-prod\nenabled=1\ngpgcheck=1\ngpgkey=https://packages.microsoft.com/keys/microsoft.asc" > /etc/yum.repos.d/dotnetdev.repo'

Install the .NET SDK

Update the products available for installation, install the components required by .NET, then install the .NET SDK.

In your command prompt, run the following commands:

Fedora 26 or more recent:
```
sudo dnf update
sudo dnf install libunwind libicu compat-openssl10
sudo dnf install dotnet-sdk-2.0.2
```
Other versions:
```
sudo dnf update
sudo dnf install libunwind libicu
sudo dnf install dotnet-sdk-2.0.2
```
Create your app

Open a new command prompt and run the following commands.
```
dotnet new console -o myApp
cd myApp
```
The dotnet command will create a new application of type console for you. The -o parameter will create a directory named myApp where your app will be stored, and populates it with the required files. The cd myApp command puts you into the newly created app directory.

The main file in the myApp folder is Program.cs. By default, it already contains the necessary code to write "Hello World!" to the Console.
```
using System;

namespace myApp
{
    class Program
    {
        static void Main(string[] args)
        {
            Console.WriteLine("Hello World!");
        }
    }
}
```
Run your app

In your command prompt, run the following command:
```
dotnet run
```
Congratulations, you've built and run your first .NET app!
Get an editor

Visual Studio Code is a free, cross-platform code editor with support for .NET.

Download Visual Studio Code

For full language support including smart code completion and debugging, get the C# extension for Visual Studio Code.

Download the C# Extension

There are also third party tools for developing .NET apps. JetBrains Rider is a cross-platform .NET IDE built using IntelliJ and ReSharper technology.
Keep learning

Now that you've got the basics, you can keep learning with the .NET Quick Starts. In the first Quick Start you'll learn about collections.

Quick start: Collections

Add the dotnet product feed

To start installing .NET, you'll need to register the Microsoft signature key and add the Microsoft Product feed. This only needs to be done once per machine.

Open a command prompt and run the following commands:

sudo rpm --import https://packages.microsoft.com/keys/microsoft.asc
sudo sh -c 'echo -e "[packages-microsoft-com-prod]\nname=packages-microsoft-com-prod \nbaseurl= https://packages.microsoft.com/yumrepos/microsoft-rhel7.3-prod\nenabled=1\ngpgcheck=1\ngpgkey=https://packages.microsoft.com/keys/microsoft.asc" > /etc/yum.repos.d/dotnetdev.repo'

Install the .NET SDK

Update the products available for installation, install the components required by .NET, then install the .NET SDK.

In your command prompt, run the following commands:
```
sudo yum update
sudo yum install libunwind libicu
sudo yum install dotnet-sdk-2.0.2
```
Create your app

Open a new command prompt and run the following commands.
```
dotnet new console -o myApp
cd myApp
```
The dotnet command will create a new application of type console for you. The -o parameter will create a directory named myApp where your app will be stored, and populates it with the required files. The cd myApp command puts you into the newly created app directory.

The main file in the myApp folder is Program.cs. By default, it already contains the necessary code to write "Hello World!" to the Console.
```
using System;

namespace myApp
{
    class Program
    {
        static void Main(string[] args)
        {
            Console.WriteLine("Hello World!");
        }
    }
}
```
Run your app

In your command prompt, run the following command:
```
dotnet run
```
Congratulations, you've built and run your first .NET app!
Get an editor

Visual Studio Code is a free, cross-platform code editor with support for .NET.

Download Visual Studio Code

For full language support including smart code completion and debugging, get the C# extension for Visual Studio Code.

Download the C# Extension

There are also third party tools for developing .NET apps. JetBrains Rider is a cross-platform .NET IDE built using IntelliJ and ReSharper technology.
Keep learning

Now that you've got the basics, you can keep learning with the .NET Quick Starts. In the first Quick Start you'll learn about collections.

Quick start: Collections

Add the dotnet product feed

To start installing .NET, you'll need to register the Microsoft signature key and add the Microsoft Product feed. This only needs to be done once per machine.

Open a command prompt and run the following commands:

sudo rpm --import https://packages.microsoft.com/keys/microsoft.asc
sudo sh -c 'echo -e "[packages-microsoft-com-prod]\nname=packages-microsoft-com-prod \nbaseurl= https://packages.microsoft.com/yumrepos/microsoft-rhel7.3-prod\nenabled=1\ngpgcheck=1\ngpgkey=https://packages.microsoft.com/keys/microsoft.asc" > /etc/zypp/repos.d/dotnetdev.repo'

Install the .NET SDK

Update the products available for installation, install the components required by .NET, then install the .NET SDK.

In your command prompt, run the following commands:

When installing the SDK, SUSE and OpenSUSE may report that nothing provides libcurl. libcurl should already be installed on supported versions of both distros. Run zypper search libcurl to confirm. The error will present 2 'solutions'. Choose 'Solution 2' to continue installing .NET.
```
sudo zypper update
sudo zypper install libunwind libicu
sudo zypper install dotnet-sdk-2.0.2
```
Create your app

Open a new command prompt and run the following commands.
```
dotnet new console -o myApp
cd myApp
```
The dotnet command will create a new application of type console for you. The -o parameter will create a directory named myApp where your app will be stored, and populates it with the required files. The cd myApp command puts you into the newly created app directory.

The main file in the myApp folder is Program.cs. By default, it already contains the necessary code to write "Hello World!" to the Console.
```
using System;

namespace myApp
{
    class Program
    {
        static void Main(string[] args)
        {
            Console.WriteLine("Hello World!");
        }
    }
}
```
Run your app

In your command prompt, run the following command:
```
dotnet run
```
Congratulations, you've built and run your first .NET app!
Get an editor

Visual Studio Code is a free, cross-platform code editor with support for .NET.

Download Visual Studio Code

For full language support including smart code completion and debugging, get the C# extension for Visual Studio Code.

Download the C# Extension

There are also third party tools for developing .NET apps. JetBrains Rider is a cross-platform .NET IDE built using IntelliJ and ReSharper technology.
Keep learning

Now that you've got the basics, you can keep learning with the .NET Quick Starts. In the first Quick Start you'll learn about collections.

Quick start: Collections

Install .NET SDK

To start building .NET apps you just need to download and install the .NET SDK (Software Development Kit) for macOS.

Download .NET SDK

If you have any problems with installation on macOS, please consult our release notes.

Video: Creating a Simple .NET Application on macOS
Create your app

Open a new command prompt and run the following commands.
```
dotnet new console -o myApp
cd myApp
```
The dotnet command will create a new application of type console for you. The -o parameter will create a directory named myApp where your app will be stored, and populates it with the required files. The cd myApp command puts you into the newly created app directory.

The main file in the myApp folder is Program.cs. By default, it already contains the necessary code to write "Hello World!" to the Console.
```
using System;

namespace myApp
{
    class Program
    {
        static void Main(string[] args)
        {
            Console.WriteLine("Hello World!");
        }
    }
}
```
Run your app

In your command prompt, run the following command:
```
dotnet run
```
Congratulations, you've built and run your first .NET app!
Get an editor

Visual Studio for Mac is a fully-featured integrated development environment (IDE) for developing .NET apps on macOS.

Download Visual Studio for Mac

There are also third party tools for developing .NET apps. JetBrains Rider is a cross-platform .NET IDE built using IntelliJ and ReSharper technology.
Keep learning

Now that you've got the basics, you can keep learning with the .NET Quick Starts. In the first Quick Start you'll learn about collections.

Quick start: Collections

Get started with .NET in 10 minutes

Tutorial Guide

Download and Install

Create your app

Run your app

Get an editor

Keep learning

Enable the .NET channel for Red Hat Enterprise Linux 7

Install and enable the .NET SDK

Create your app

Run your app

Get an editor

Keep learning

Add the dotnet product feed

Register the trusted Microsoft signature key:

Register the Microsoft Product feed

Ubuntu 17.10

Ubuntu 17.04

Ubuntu 16.04 / Linux Mint 18

Ubuntu 14.04 / Linux Mint 17

Install .NET SDK

Create your app

Run your app

Get an editor

Keep learning

Add the dotnet product feed

Install system components

Register the trusted Microsoft Product key

Register the Microsoft Product feed

Debian 9 (Stretch)

Debian 8 (Jessie)

Install .NET SDK

Create your app

Run your app

Get an editor

Keep learning

Add the dotnet product feed

Install the .NET SDK

Fedora 26 or more recent:

Other versions:

Create your app

Run your app

Get an editor

Keep learning

Add the dotnet product feed

Install the .NET SDK

Create your app

Run your app

Get an editor

Keep learning

Add the dotnet product feed

Install the .NET SDK

Create your app

Run your app

Get an editor

Keep learning

Install .NET SDK

Create your app

Run your app

Get an editor

Keep learning