Installation

Complete guide to installing NØNOS development environment.

---

Step 1: Install Rust

Install rustup if you haven't already:

curl --proto '=https' --tlsv1.2 -sSf https://sh.rustup.rs | sh
source ~/.cargo/env

Install the nightly toolchain:

rustup toolchain install nightly
rustup target add x86_64-unknown-uefi --toolchain nightly
rustup component add rust-src llvm-tools-preview --toolchain nightly

---

Step 2: Install Build Dependencies

Linux (Debian/Ubuntu)

sudo apt update
sudo apt install qemu-system-x86 ovmf build-essential

Linux (Fedora)

sudo dnf install qemu-system-x86 edk2-ovmf make gcc

Linux (Arch)

sudo pacman -S qemu-full edk2-ovmf base-devel

macOS

brew install qemu
xcode-select --install  # Command Line Tools required

Windows (WSL2)

1. Install WSL2 with Ubuntu:

   wsl --install -d Ubuntu

2. Inside Ubuntu WSL, follow the Linux instructions

---

Step 3: Clone the Repositories

git clone https://github.com/NON-OS/nonos-kernel.git
cd nonos-kernel
git clone https://github.com/NON-OS/nonos-boot.git

---

Step 4: Verify Dependencies

make check-deps

This verifies:

• Rust is installed

• Nightly toolchain available

• UEFI target added

---

Step 5: Build

make nonos

The Makefile automatically generates a development signing key if dev_signing_key.bin doesn't exist.

Expected output:

Building NØNOS Bootloader...
================================
Bootloader built successfully

Building NØNOS Kernel...
================================
Kernel built successfully

Preparing EFI System Partition...
================================
ESP prepared at target/esp

============================================
  NØNOS BUILD COMPLETE!
============================================
  Run 'make run' to test in QEMU
  Run 'make iso' to create bootable ISO
============================================

---

Step 6: Run in QEMU

make run

You should see the NØNOS boot sequence and desktop.

---

Troubleshooting

"Rust not installed"

curl --proto '=https' --tlsv1.2 -sSf https://sh.rustup.rs | sh
source ~/.cargo/env

"nightly toolchain not found"

rustup install nightly

QEMU fails to start

Verify OVMF is installed:

# Linux
ls /usr/share/OVMF/OVMF_CODE.fd

# macOS (bundled with QEMU)
ls $(brew --prefix qemu)/share/qemu/edk2-x86_64-code.fd

macOS build errors

Ensure Command Line Tools are installed:

xcode-select --install