Install .NET Core Apps on Linux in 5 Minutes
As a big fan of open source, I’m loving the fact that .NET Core is cross-platform. It opens up endless possibilities, from hobby projects, experiments, and proofs of concept, to massive high-load production applications that run on cost-effective infrastructure with high security and scalability. I usually get the simplest and cheapest $5/month Ubuntu-based virtual private server (VPS) from any cloud platform provider instead of the more complex and expensive container instances or cloud computing services.
I’m going to guide you through the steps on how to set up a .NET Core runtime environment, and how to deploy a .NET Core web application with Okta authentication, once you’ve got an Ubuntu VPS, all using nothing more than the Terminal.
The Benefits of Using Okta
Okta is a cloud service that allows developers to create, edit, and securely store user accounts and user account data, and connect them with one or multiple applications. Using Okta, you don’t have to worry about implementing sign up, login and logout flows manually. In our sample app, we will set up Okta to handle our user management for OAuth sign-in. There are a few tricks to set up .NET Core to work on Linux (especially when it comes to containerization on a host like AWS or Azure), but don’t worry — you will get a good overview in this tutorial.
Prerequisites
Install .NET Core SDK/Runtime on Linux
.NET Core SDK or Runtime: Which One Is Best
The .NET Core runtime allows you to run applications on Linux that were made with .NET Core but didn’t include the runtime. With the SDK you can run but also develop and build .NET Core applications. Normally you would need only the runtime in a production environment and the SDK in a development environment.
Today we are going to build and run our sample application on the same machine. So let’s install the .NET Core SDK.
Adding the Package Repository
We need to add Microsoft’s package signing key to make the package repository trusted by the system.
Open Terminal and run the following commands:
Installing the SDK
To make sure the installation was successful, run:
The output should be the installed .NET Core version.
Building and Running a .NET Core application on Linux
We are going to use the .NET Core CLI to build and run the sample application.
Copying the source code
I have prepared a sample application for the sake of this example. Let’s use git to copy it to our machine from GitHub.
Building the .NET Core Application
Enter the folder where we just copied the source code:
The first build might take a while. Then the output should be something like:
Running the .NET Core Application
To run the application in Development mode, type:
Running the sample application will fail because we need to set up Okta login first.
Quickly Set Up Okta Login
Navigate to Applications , then select Add Application . 
Select Web as a platform: 
On the next screen add the following: Login redirect URIs: https://localhost:5001/authorization-code/callback
Logout redirect URIs: https://localhost:5001/signout/callback 
When finished, click Done. 
Take note of your client credentials ( Client ID and Client secret). 
Open appsettings.json in your favorite code editor and add your credentials. 
You can find your Org URL in the top right corner of the Dashboard: 
Now the sample app is ready to run:
You can now open a browser window at http://localhost:5000 to see the application running. Also you can try logging with Okta in the top right corner.
Troubleshooting
In case you run into a Correlation Error after logging in with Okta, you need to manually set the SameSite cookie attribute to None , and enable SSL (HTTPS) on your server. Check out more about how SameSite affects your apps in this article.
Takeaways
Developing .NET Core applications on Linux is not the stuff of science fiction any more. Since Microsoft started moving away from closed-source and platform-dependent solutions, a Linux-based development environment has its advantages. I believe tools like VSCode and Rider—also available on every platform—are mature enough to make them reasonable competitors of the classic Visual Studio IDE for Windows. I’ve successfully used Linux as my primary development environment for .NET Core for a few years now. Give it a try yourself and let us know what your experience has been in the comments below!
Learn More About .NET and Okta
If you are interested in learning more about security and .NET check out these other great articles:
Don’t forget to follow us on Twitter and subscribe to our YouTube channel for more great tutorials.
Запуск консольного приложения ASP.net Core на Linux
Так как .NET Core нет в стандартных репозиториях для Linux, то нужно добавить источник на скачивание пакетов.
для Ubuntu 14.04 / Linux Mint 17 будет выглядеть так:
Установим .NET Core SDK
Ждем пока cкачаются и установятся пакеты
Проверим версию dotnet
Создадим папку в /home для наших тестов
например asptest
Консольное приложение «Hello World!»
Начнем с простого консольного приложения ASP.Net Core которое запустим на Ubuntu
Откроем Visual Studio на Windows и создадим проект. Выберем Консольное приложение (.NET Core), имя оставим таким как есть «ConsoleApp1»
Откроется наш проект с заготовкой «Hello word!». Ничего не будем менять. Запустим его что бы он скомпилировался.
Откроем папку ConsoleApp1\ConsoleApp1\bin\Debug\netcoreapp1.1\
Найдем там скомпилированный проект.
ASP.NET Core: ваше первое приложение на Linux c использованием Visual Studio Code
Решил недавно написать небольшое ASP.Net MVC приложение после многолетнего перерыва и знающие люди на Хабре подсказали попробовать новый ASP.Net Core, тем более, что он работает в Линуксе из коробки без необходимости задействовать mono, и, судя по последним тестам, даже показывает неплохую производительность. За основу взял аналогичную статью для Mac, однако здесь в отличии от вдохновившей меня статьи хочу описать процесс пошагово в одном месте, для того, чтобы не пришлось лазить по перекрёстным ссылкам, пытаясь разобраться как установить непонятно для чего предназначенные приложения и пакеты. Такое подробное описание процесса возможно поможет многим избежать граблей, с которыми пришлось столкнуться мне. Несколько фраз и рисунков, в части одинаковой для любой платформы, с правками и корректировками взяты из статьи для Mac.
Установка .Net Core и Visual Studio Code
Приводимые здесь команды установки подходят для дистрибутивов Ubuntu 16.04/Mint 18.x, для остальных можно найти здесь.
Установка .Net Core:
Устанавливаем новейший на данный момент RC4 для совместимости с новейшим генератором проектов aspnet:
Установка Visual Studio Code
Устанавливается легко в пару кликов по этой ссылке.
Установка расширения C#
Запускаем Visual Studio Code, нажимаем Ctrl-P, вводим команду:
ext install csharp
В появившейся слева панели нажимаем «Установить» напротив соответствующего расширения, если это не произошло автоматически. Visual Studio Code можно пока закрыть.
Подготовка среды разработки и формирование шаблонов приложений
Устанавливаем новейший node.js с оригинального сайта (тот, что идёт с дистрибутивом не подходит), он нам нужен из-за менеджера пакетов npm, который идёт вместе с ним:
Для других дистрибутивов инструкция здесь.
Инициализация проекта
Для инициализации используется скаффолдер Yeoman — инициализатор проекта, включающий в себя развёртывание файловой структуры и генерацию шаблона проекта, т.е. исходного кода приложения. Включает в себя скаффолдер Yo, менеджер пакетов Bower и менеджер задач Grunt. При установке Yo вам будут установлены также Bower и Grunt. Здесь устанавливаем в любом терминале также новейший генератор aspnet, в котором возвращена система сборки msbuild вместо project.json:
Запуск генератора проекта
- Выбираем пункт Web Application Basic [without Membership and Authorization] и нажимаем Enter
- Выбираем Bootstrap (3.3.6) в качестве фреймворка UI и нажимаем Enter
- Оставляем имя «WebApplicationBasic» в качестве имени приложения и нажимаем Enter
- Установка: npm install -g generator-aspnetpostgresql
- Генерация шаблона: yo aspnetpostgresql
Восстановить и собрать можно, а вот запускать пока рано: нужно ещё кое что сделать.
Разработка приложений ASP.NET Core MVC на Linux с помощью Visual Studio Code
Теперь запустите Visual Studio Code. 
Выберите пункт Файл → Отрыть папку и выберите папку, в которой Вы создали шаблон приложения ASP.NET Core MVC с помощью yo.
При первом запуске Visual Studio Code выдаст предупреждение об отсутствии необходимых инструментов для сборки и отладки. Нажимаем Yes , чтобы добавить их. Без этого автоматическая отладка и сборка средствами Visual Studio Code будет недоступна, а только через терминал командами dotnet build и dotnet run .
В Терминале Visual Studio Code (Ctrl-`) выполните команду dotnet restore , чтобы восстановить зависимости проекта (если не сделали этого раньше). Другой способ — выполнить команду Ctrl-Shift-P в Visual Studio Code и затем ввести dot, как показано ниже (у меня почему-то не заработало):
Для тех, кто только приступает к использованию Visual Studio Code (или Code, для краткости), следует заметить, что данный продукт не только имеет удобный, простой и отзывчивый интерфейс, обеспечивающий быструю работу с файлами, но он также предоставляет инструменты для наиболее эффективного написания кода.
- Explore
- Search
- Git
- Debug
- Extensions
Code интегрируется с Git, если он установлен на вашем компьютере. При помощи Git viewlet можно создавать новые репозитории, подтверждать изменение кода, отправлять изменения.
Debug viewlet поддерживает интерактивную отладку приложений.
Кроме того, в редакторе Code есть множество замечательных функций. Вы увидите, что неиспользованные операторы using будут подчеркнуты и могут быть удалены автоматически при помощи Сtrl-. , если значок лампочки отображается на экране. Также можно видеть, сколько ссылок на классы и методы есть в проекте. Если вы переходить с Visual Studio, то вы можете использовать многие знакомые сочетания клавиш, например, Сtrl-K+C , чтобы закомментировать блок кода или Ctrl-K-U , чтобы раскомментировать его.
Запуск приложения при помощи Kestrel
- Установив .Net Core Project Manager (Nuget) через viewlet Extensions (Расширения): Ctrl-Shift-P , набираем Nuget , ↵, затем Kestrel ↵ выбираем Microsoft.AspNetCore.Server.Kestrel
- Через командную строку в терминале редактора vs code editor:
Всё, теперь можно запускать: нажимаем F5 или в терминале dotnet run , при этом автоматически запускается браузер с приложением по адресу: localhost:5000 . Чтобы остановить веб-сервер, нажмите Ctrl+C. Вот и всё, можете наслаждаться вашим первым приложением ASP.Net Core: 
You can host a .NET Core MVC app on Linux
I’ve missed the beginning of .NET Core, so I’ve just recently discovered that one can host a .NET Core MVC web-application on a Linux server. I always liked C#/.NET, but I didn’t like to be tied to IIS/Windows platform, so that looked very interesting to me.
The whole setup-from-scratch process takes about 15 minutes. I kid you not! And below I will show you it step-by-step (based on this instruction) — how to host a .NET Core MVC application with NGINX and Kestrel on a Linux server.
Publishing
- Clean, out-of-the-box, remote Linux server running some Linux
- Some .NET Core MVC application ready for deployment
Connect to your server via SSH:
Install .NET Core for Linux on your server and check if it works:
On your local machine publish your project by running the following from the project folder:
Create a website folder on the server:
And copy the contents of ../_deploy from your machine to /var/www/YOUR-WEBSITE/ on the server.
Change the owner of your website’s directory so it would belong to NGINX’s user ( www-data ):
systemd service
Create a systemd config for Kestrel instance:
Edit it like that:
Enable and start it:
You can check its status:
If everything is okay, then it will show something like that:
NGINX
Now, there are 2 options how NGINX can send requests to Kestrel: via TCP or via Unix socket.
NGINX config ( /etc/nginx/sites-available/default ):
Unix socket
This should be better in terms of performance as there is no TCP overhead. Even if there was no performance impact, on a local machine “talking” through Unix socket simply makes more sense than communicating over TCP.