Getting Started

Installation

VernisOS requires a specific build toolchain to compile the bootloader, kernel, and user-space components from Assembly, C, and Rust source code.

Prerequisites

You need the following tools installed on your system:

NASM

Netwide Assembler — builds the bootloader

GCC

GNU Compiler Collection — compiles C kernel code

Rust

no_std toolchain — builds the AI engine

QEMU

x86/x64 emulator — runs the OS image

Make

GNU Make — orchestrates the build process

GNU Linker — links object files into binary

Install on Ubuntu / Debian

bash

sudo apt update
sudo apt install -y build-essential nasm qemu-system-x86 qemu-system-x86-64

# Install Rust toolchain
curl --proto '=https' --tlsv1.2 -sSf https://sh.rustup.rs | sh
rustup default stable
rustup component add rust-src --toolchain stable-x86_64-unknown-linux-gnu

Install on macOS

bash

# Install via Homebrew
brew install nasm qemu

# Install Rust toolchain
curl --proto '=https' --tlsv1.2 -sSf https://sh.rustup.rs | sh
rustup default stable
rustup component add rust-src

Verify Installation

bash

nasm --version      # Should show NASM version >= 2.15
gcc --version       # Should show GCC version >= 9
rustc --version     # Should show Rust version >= 1.70
qemu-system-x86_64 --version  # Should show QEMU version >= 6

Alternatively, run make prerequisites from the project root to check all dependencies automatically.

← Overview First Boot →