Getting Started On Linux


The following prerequisites are necessary:

If using the APT package manager, you can use the following commands to quickly set everything up:

# Register Microsoft package repository
wget -q -O packages-microsoft-prod.deb
sudo dpkg -i packages-microsoft-prod.deb

# Install the .NET Core SDK
sudo add-apt-repository universe
sudo apt-get update
sudo apt-get install apt-transport-https
sudo apt-get update
sudo apt-get install dotnet-sdk-5.0
sudo snap install dotnet-sdk --classic
sudo snap alias dotnet-sdk.dotnet dotnet

# Intall QEMU and GIT
sudo apt-get -y install qemu qemu-system qemu-system-x86 git


The MOSA project is available as a zip download or via git:

git clone


Next, compile the tool set:

cd MOSA-Project
dotnet build Source/Mosa.Linux.sln


To validate everything is working properly, execute the unit tests:

dotnet bin/Mosa.Utility.UnitTests.dll -oMax -s Emulator.Display=false