A rusty OS kernel.

If using rustup (recommended):

rustup install nightly

The rust-toolchain file should select this by default once installed.

This is a cargo subcommand tool, not a Rust crate dependency, so has to be installed manually:

cargo install bootimage

On Ubuntu/Debian:

sudo apt update
sudo apt install qemu-system-x86

On Fedora:

sudo dnf install qemu-system-x86

On Arch Linux:

sudo pacman -S qemu

Note: QEMU is used here, but other emulators will work but have to be configured manually.

Use the configured cargo runner with:

cargo run

cargo bootimage

Run QEMU manually (or via run.sh):

GTK_PATH=/usr/lib/x86_64-linux-gnu/gtk-3.0 \
GTK_MODULES="" \
qemu-system-x86_64 -drive format=raw,file=target/x86_64_os/debug/bootimage-oxide_os.bin

Note: To avoid GTK-related errors with QEMU when running through bootimage runner, make sure your environment variables are set correctly (see below).

To avoid GTK symbol lookup errors when running QEMU inside VS Code, set these environment variables in your workspace settings.

Create or update .vscode/settings.json with:

{
  "terminal.integrated.env.linux": {
    "GTK_PATH": "/usr/lib/x86_64-linux-gnu/gtk-3.0",
    "GTK_MODULES": ""
  }
}

This ensures the integrated terminal in VS Code has the correct GTK environment for QEMU.