https://github.com/oro-os/kernel
Kernel for the Oro Operating System
https://github.com/oro-os/kernel
hybrid-kernel kernel microkernel operating-system operating-system-kernel
Last synced: about 1 month ago
JSON representation
Kernel for the Oro Operating System
- Host: GitHub
- URL: https://github.com/oro-os/kernel
- Owner: oro-os
- License: mpl-2.0
- Created: 2022-07-26T03:18:11.000Z (almost 3 years ago)
- Default Branch: master
- Last Pushed: 2025-03-30T23:27:25.000Z (3 months ago)
- Last Synced: 2025-03-31T00:21:42.073Z (3 months ago)
- Topics: hybrid-kernel, kernel, microkernel, operating-system, operating-system-kernel
- Language: Rust
- Homepage: https://oro.sh
- Size: 2.06 MB
- Stars: 55
- Watchers: 5
- Forks: 3
- Open Issues: 10
-
Metadata Files:
- Readme: README.md
- Contributing: CONTRIBUTING.md
- Funding: .github/FUNDING.yml
- License: LICENSE
- Security: SECURITY.md
Awesome Lists containing this project
README
Oro Operating System
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.
## Building
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):
```shell
git submodule update --init --recursive --depth=1
```
Then, to build the kernel itself:
```shell
cargo kernel-x86_64
cargo kernel-aarch64
```
To build a bootloader:
```shell
cargo limine-x86_64
cargo limine-aarch64
```
## Documentation
The Oro kernel is thoroughly documented. You may generate a local copy of
the documentation with:
```shell
cargo oro-doc --open
```
## Security
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](SECURITY.md) for instructions on how to responsibly disclose
your findings.
# License
The Oro Operating System kernel is © 2016-2025 by Joshua Lee Junon,
and licensed under the [Mozilla Public License 2.0](LICENSE).
Certain crates within this repository are dual-licensed under the
MIT and Apache-2.0 licenses, typically when published to the [crates.io](https://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.