V
VernisOS
Guide

Getting Started

Follow these steps to get VernisOS running on your machine in minutes.

01

Install Prerequisites

Set up the build toolchain on your system.

bash
# Ubuntu/Debian
sudo apt update
sudo apt install build-essential nasm qemu-system-x86

# macOS (with 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
02

Clone & Build

Get the source code and compile everything.

bash
git clone https://github.com/Pakawat-Tan/VernisOS.git
cd VernisOS

# Verify toolchain
make prerequisites

# Build the OS image
make
03

Run in QEMU

Boot VernisOS in the QEMU emulator.

bash
# Run x64 version
make run64

# Run x86 version
make run32
04

Try the CLI

Log in and explore the command system.

bash
# Login (default: admin/admin)
login

# Check system status
ai_status

# List files
ls

# Get help
help

Ready to dive deeper?