Kernel and associated bootloaders for the Oro Operating System,
a general-purpose, minimal, and novel microkernel operating system written in Rust.
« oro.sh | discord | x »
This is the home of the Oro Operating System kernel and bootloader crates. All code necessary to build and run the kernel is provided in this repository.
Caution
The Oro Operating System is currently in the early stages of development. It is not yet suitable for use in a production environment.
The kernel is built standalone and used as a module for a bootloader entry point. The kernel does not support being booted to directly.
ACPI support uses a submodule; be sure it's checked out (one-time setup):
git submodule update --init --recursive --depth=1
Then, to build the kernel itself:
cargo kernel-x86_64 cargo kernel-aarch64
To build a bootloader:
cargo limine-x86_64 cargo limine-aarch64
The Oro kernel is thoroughly documented. You may generate a local copy of the documentation with:
cargo oro-doc --open
If you have found a vulnerability within the Oro kernel or any of the associated crates included in this repository, please do not open an issue and instead consult SECURITY.md for instructions on how to responsibly disclose your findings.
The Oro Operating System kernel is © 2016-2025 by Joshua Lee Junon,
and licensed under the Mozilla Public License 2.0.
Certain crates within this repository are dual-licensed under the
MIT and Apache-2.0 licenses, typically when published to the crates.io
registry. Those crates will contain a LICENSE.mit and LICENSE.apache-2.0 file
and are not subject to the MPL-2.0 license to which the rest of this repository
is subject.