Skip to content



Folders and files

Last commit message
Last commit date

Latest commit


Repository files navigation


A small kernel with basic functionality written in Rust. Currently only parts of memory management and the keyboard driver are any interesting.


It paints the screen bright red and then displays some information. You can write. That's it:


You need a few things to run rustboot:

  1. Rust's master branch
  2. qemu
  3. On x86
  • clang
  • nasm
  1. On ARM
  • binutils for arm-none-eabi
  • gcc cross-compiler
  1. Optionally for debugging
  • gdb
  • tmux

Clone this repository.

$ git clone
$ cd rustboot

To get edge Rust going, grab it from git:

$ git clone
$ cd rust
$ ./configure --target=i686-unknown-linux-gnu
$ make && make install

You can considerably minimize build time:

$ ./configure --target=i686-unknown-linux-gnu --llvm-root=/usr
$ make rustc-stage1

Then use the rust/*/stage1/bin/rustc binary to compile rustboot:

$ echo "RUST_ROOT:=$(pwd)/x86_64-unknown-linux-gnu/stage1/bin" > rustboot/

Arch Linux

Simply install all dependencies:

# pacman -S qemu nasm rust clang gdb tmux
# yaourt -S gcc-arm-none-eabi


To set things up on OSX, do this:

Install nasm and qemu from homebrew:

$ brew install nasm
$ brew install qemu

Install latest binutils from source.

$ wget ''
$ ./configure --target=i386-elf
$ make && make install

Running it

To compile, simply execute make command.

To run, use:

$ make run # emulate default platform (x86)
$ make arch=arm run   # run on ARM
$ make arch=arm debug # debug on ARM


No packages published


  • Rust 85.6%
  • Assembly 9.7%
  • Makefile 4.7%