MOROS: Obscure Rust Operating System 🦉
You can not select more than 25 topics Topics must start with a letter or number, can include dashes ('-') and can be up to 35 characters long.
Vincent Ollivier d2722f85ee
Improve shell autocompletion (#448)
6 days ago
.cargo Remove dependency on rlibc (#115) 2 years ago
.github Read command line args from userspace programs (#351) 6 months ago
doc Update main screenshot 1 week ago
dsk Replace some rust programs with lisp scripts (#445) 7 days ago
run Remove allow other (#447) 6 days ago
src Improve shell autocompletion (#448) 6 days ago
www Add socket command (#341) 7 months ago
.gitignore Update gitignore 2 years ago
.static Add website (#261) 1 year ago Publish version 0.9.0 4 weeks ago
Cargo.lock Bump smoltcp from 0.8.1 to 0.8.2 (#443) 1 week ago
Cargo.toml Bump smoltcp from 0.8.1 to 0.8.2 (#443) 1 week ago
LICENSE Update copyright year 8 months ago
Makefile Use git describe to display version (#437) 4 weeks ago Improve http timeout (#397) 3 months ago
rust-toolchain.toml Update rust version (#432) 1 month ago
x86_64-moros.json Add password hashing 3 years ago

MOROS: Obscure Rust Operating System


MOROS is a hobby operating system written in Rust by Vincent Ollivier.

It targets computers with a x86-64 architecture and a BIOS, so mostly from 2005 to 2020, but it also runs well on most emulators (Bochs, QEMU, and VirtualBox).

This project started from the seventh post of the second edition of Writing an OS in Rust by Philipp Oppermann and by reading the OSDev wiki along with many open source kernels.



  • External bootloader (using bootloader)
  • x86 CPU support (using x86_64)
  • Hardware interrupts (using pic8259)
  • PS/2 Keyboard with customizable layout (using pc-keyboard)
  • VGA Text mode with customizable font and color palette
  • Serial output (using uart_16550)
  • Paging
  • Heap allocation (using linked_list_allocator)
  • ACPI shutdown (using acpi and aml)
  • RTC clock
  • PCI devices
  • ATA PIO mode
  • Random number generator (using rand_hc)
  • RTL8139 network card
  • AMD PCNET network card
  • DHCP/IP/TCP/UDP/DNS/HTTP network protocols (using smoltcp)
  • Basic filesystem
  • Basic shell
  • Basic text editor
  • Basic lisp interpreter
  • Basic file and network commands
  • Basic userspace for NASM and Rust programs without alloc
  • Multitasking
  • C standard library port


Documentation is available here


Clone the repo:

$ git clone
$ cd moros

Install the required tools with make setup or the following commands:

$ curl -sSf | sh
$ rustup install nightly
$ rustup default nightly
$ cargo install bootimage


Build the image to disk.img:

$ make image output=video keyboard=qwerty


$ make qemu output=video nic=rtl8139

Run natively on a x86 computer by copying the bootloader and the kernel to a hard drive or USB stick (but there is currently no USB driver so the filesystem will not be available in that case):

$ sudo dd if=target/x86_64-moros/release/bootimage-moros.bin of=/dev/sdx && sync

MOROS will open a console in diskless mode after boot if no filesystem is detected. The following command will setup the filesystem on a hard drive, allowing you to exit the diskless mode and log in as a normal user:

> install

Be careful not to overwrite the hard drive of your OS when using dd inside your OS, and install or disk format inside MOROS if you don't use an emulator.


Run the test suite in QEMU:

$ make test


MOROS is released under MIT.