Skip to content

Modern OS written in the rust programming language

License

Notifications You must be signed in to change notification settings

GandelXIV/RezOS

Repository files navigation

RezOS

A modern operating system written in the rust programming language.

premise:

  • Rust as a primary language for safety, speed and security
  • Modern bootloader support with the limine protocol
  • Architectural compatibility for x86_64 and AARCH64/ARM64
  • Innovative approach to Micro/Monolithic kernel design
  • Graph VFS
  • Capability based permissions
  • Proper async IO interface
  • Running DOOM
  • Full network & graphics stack

Setup instructions

A. download the source code

  1. Clone the source repository
    git clone https://www.github.com/GandelXIV/RezOS.git
  2. Update git submodules
    git submodule update --init --progress

B. Prepare the environment

Install dependencies, there are 2 ways of doing this:

Locally

This option is only viable on linux, so if you are on a different platform consider using the Docker method.

Use an install script located in scripts/install/all/{your-distro}.sh.
If your distro does not have a script, you can still use scripts/install/rust-linux.sh to setup rust, then install all the packages in scripts/install/packages/packages.md manually

Inside Docker

This option is cross-platform and does not polute your system with pkgs, however is harder to operate.

  1. Install docker
  2. Build the container as described in docker/setup.sh or scripts/docker/setup.sh
  3. Before compiling, start the container environment with docker/run.sh or scripts/docker/run.sh. Once the environment is up and running, cd into /home/rezos and carry on with compiling.

C. Configure

One last step before compiling is to configure the project, you need to do this only once.
Either run ./config.sh or follow the steps in config/README.md.

D. Compile!

The whole system can be built with make, this produces a RezOS-x86_64.iso file in build/ that can then by run in an emulator with make run-x86_64

  • If you wish to target aarch64, simply replace the x86_64in the make commands with it.
  • More make options are documented in the Makefile header