Skip to content


Switch branches/tags

Name already in use

A tag already exists with the provided branch name. Many Git commands accept both tag and branch names, so creating this branch may cause unexpected behavior. Are you sure you want to create this branch?

Latest commit


Git stats


Failed to load latest commit information.
Latest commit message
Commit time

This README file contains information on the contents of the aspnet layer.

Please see the corresponding sections below for details.


This layer depends on:

  URI: git://
  branch: pyro

  URI: git://
  layers: meta
  branch: pyro

  URI: git://
  branch: pyro

The build machine also needs .NET Core installed:

For .NET Core, you'll also need

  branch: pyro


You are encouraged to fork this repository and share your patches.

Maintainer: Kai Ruhnau


Since some time now, Microsoft has opened up many of their .NET related projects. This repository tries to bring this into the OpenEmbedded/Yocto environment. The main focus at the moment is the ASP.NET Core infrastructure which provides a full server-side HTTP web stack and programming environment.

There is a dotnet.bbclass that helps building ASP.NET Core projects. As samples for its usage, the dotnet-console and dotnet-web recipes are provided and build the dotnet new console and web application respectively. These projects are based off of .NET Core and don't yet run in an actual image (see below). They serve as a test bed for the build infrastructure. Actual projects have to target the "net471" framework or similar to run with Mono >= 5.12.

Adding the aspnet layer to your build

In order to use this layer, you need to make the build system aware of it.

Assuming the aspnet layer exists at the top-level of your yocto build tree, you can add it to the build system by adding the location of the aspnet layer to bblayers.conf, along with any other layers needed. e.g.:

  BBLAYERS ?= " \
    /path/to/yocto/meta \
    /path/to/yocto/meta-yocto \
    /path/to/yocto/meta-yocto-bsp \
    /path/to/yocto/meta-mono \
    /path/to/yocto/meta-aspnet \

.NET Runtime

There has always been Mono available as the .NET implementation outside the Windows universe. Mono as runtime isn't "officially" supported by Microsoft, but that only means that you cannot pay Microsoft to give you support. Your author has tested the 2.1 RTM version with mono 5.12 on his embedded i.MX6 ARM platform.

Since version 2.1, there's official support for Linux/ARM in .NET Core. This layer contains a dotnet-source-build recipe that's based off of and compiles a runtime and shared library of .NET Core, but not the SDK. The source-build build process isn't yet very compatible with the cross-compilation environment in bitbake, so for the time being these recipes are limited to ARM. .NET Core has official support for x86 and x64 and it might be possible to adapt the recipe for those. Aarch64/ARM64 is supported starting with .NET Core 2.2. If you want to use that and adapt the recipe accordingly, I'd appreciate a PR.


Yocto layer for ASP.NET with a focus on VNext







No releases published


No packages published