Need help with kernel?
Click the “chat” button below for chat support from the developer who created it, or find similar developers for support.

About the developer

231 Stars 16 Forks Other 1.2K Commits 48 Opened issues


The Stupid Operating System

Services available


Need anything else?

Contributors list

Stupid Operating System

Build Status MIT License Latest RustDoc Gitter

SOS is a simple, tiny toy OS implemented in Rust.

I'm writing this mostly for fun, to learn more about OS design and kernel hacking, so don't expect anything new or exciting out of this project.

Inspiration, and a reasonable amount of code, taken from @phil-opp's great series of blog posts on the subject, Charlie Somerville's rustboot, and Samy Pessé's How to Make an Operating System.

design goals

  • POSIX compliance is not a goal (though it would be cool)
  • Hybrid/loosely microkernel (i.e., move code to user space when convenient/practical)
  • Possibly provide the Rust stdlib at the OS level.
  • JVM-style memory allocation?
  • Possibly experiment with a Plan 9-esque networking stack eventually?

building & running

I've included a simple

to automate building and running SOS. This README lists most of the important make targets, but there's also a

$ make help
command, which will print a list of all available targets.

setting up your build environment

In order to build SOS, you'll need to properly configure your build environment. Since this process is fairly complex, I've provided some automatic installation shell scripts to make it a bit more painless.

  • $ make env
    will install and configure build dependencies

If you don't trust the scripts, or if you're curious to know what they're doing, you can also follow the manual install instructions in

building & running the OS

  • $ make kernel
    compiles & links the kernel binary
  • $ make iso
    makes the kernel and builds a bootable ISO image
  • $ make run
    compiles the kernel, makes the ISO, and boots QEMU from the ISO

We use cookies. If you continue to browse the site, you agree to the use of cookies. For more information on our use of cookies please see our Privacy Policy.