Setting up your Environment

Complete environment setup for NØNOS development.

---

Rust Toolchain

Install Rust

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

Install Nightly Toolchain

rustup toolchain install nightly

Add Required Components

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

---

Platform Setup

Linux (Debian/Ubuntu)

sudo apt update
sudo apt install -y \
    qemu-system-x86 \
    ovmf \
    build-essential \
    git

Linux (Arch)

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

Linux (Fedora)

sudo dnf install -y \
    qemu-system-x86 \
    edk2-ovmf \
    make \
    gcc \
    git

macOS

# Install Homebrew if needed
/bin/bash -c "$(curl -fsSL https://raw.githubusercontent.com/Homebrew/install/HEAD/install.sh)"

# Install QEMU
brew install qemu

# Install Command Line Tools (required for kernel build)
xcode-select --install

Windows (WSL2)

Enable WSL2:

wsl --install -d Ubuntu

Inside Ubuntu WSL, follow Linux instructions

---

Verify Installation

# Check Rust
rustc --version
cargo --version
rustup show

# Check QEMU
qemu-system-x86_64 --version

# Check build tools
make --version

---

Verify NØNOS Build Dependencies

cd nonos-os
make check-deps

This verifies:

• Rust is installed

• Nightly toolchain available

• UEFI target installed

---

IDE Setup

VS Code

Recommended extensions:

• rust-analyzer

• CodeLLDB (for debugging)

• Even Better TOML

CLion / RustRover

• Enable Rust plugin

• Set toolchain to nightly

---