Getting Started On Windows

Prerequisites

Install any edition of Visual Studio version 2019 or newer.

Note: The MOSA source code repository includes the Qemu virtual emulator for Windows.

Download

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

git clone https://github.com/mosa/MOSA-Project.git

If downloaded via zip, unzip the file.

Build

Execute the Compiler.bat script in the base directory in the root directory to build and compile all the MOSA tools, kernels and demos.

Compiler.bat

or compiled from the command line:

dotnet build Source\Mosa.sln

A successful build will display a Build succedded message (like below). Any warnings may be ignored.

[... lines removed...]

Build succeeded.
0 Warning(s)
0 Error(s)

Time Elapsed 00:00:01.48

Launch

To launch one of the demo application, execute the Launcher.bat script to start the MOSA Launcher Tool. This tool:

  • Compiles the operating system

  • Creates a virtual disk image, with the compiled binary and boot loader

  • Launches a virtual machine instance (using QEMU by default)

By default, the CoolWorld demo operating system is pre-selected. Click the Compile and Run button to compile and launch the demo.

Starter Project

A pre-built starter C# project template is available for experimentation.

Option #1 (Preferred - includes the entire MOSA project):

Open the Source\Mosa.sln solution with Visual Studio and locate the Mosa.Demo.MyWorld.x86 under Demos.

Next, set the project as Set as Startup Project.

To compile and launch the application within a virtual machine, select from the Debug menu the Start Without Debugging option, or press CTRL+F5.

Option #2 (Only the starter project):

Open the Source\Mosa.Demo.MyWorld.x86\Mosa.Demo.MyWorld.x86.csproj project with Visual Studio.

To compile and launch the application within a virtual machine, select from the Debug menu the Start Without Debugging option, or press CTRL+F5.