Skip to content
A simple OS kernel for research, teaching, and fun.
C Assembly Other
Branch: master
Clone or download

Latest commit

dthain User cleanup (#256)
* Trim user level programs down to basic set.

* mandelbrot -> fractal

* Break out readline in user shell.
Latest commit 28bd555 Sep 10, 2019


Type Name Latest commit message Commit time
Failed to load latest commit information.
include Livestat: A User Tool to dynamically display basekernel stats (#252) Sep 6, 2019
kernel Livestat: A User Tool to dynamically display basekernel stats (#252) Sep 6, 2019
user User cleanup (#256) Sep 10, 2019
.gitignore Added cross/ to .gitignore Sep 26, 2018
.travis.yml Travis CI Integration (#249) Jan 30, 2019
LICENSE Initial commit Dec 23, 2015
Makefile Fix order of argv and argc (#241) Jan 21, 2019
Makefile.config Set Makefile to work out of the box on RHEL7@ND. Jan 18, 2019 Update README to reflect cdromfs Dec 20, 2018
basekernel.indent Put file names after arguments Dec 20, 2018 add i686-elf-gdb to cross compiler script Oct 22, 2018
screenshot.png Update screenshot to show user level process. Sep 13, 2017

The Basekernel Operating System Kernel

Basekernel is a simple operating system kernel for research, teaching, and fun.

Basekernel is not a complete operating system, but it is a starting point for those who wish to study and develop new operating system code. If you want to build something different than Windows, Linux, or Multics, Basekernel may be a good place to try out your new ideas.

Basekernel can boot an Intel PC-compatible virtual machine in 32-bit protected mode, with support for VESA framebuffer graphics, ATA hard disks, ATAPI optical devices, process management, memory protection, simple graphics, and basic filesystem. From there, it's your job to write user-level programs and expand the system.

To be clear, this is raw low-level code, not a production system. If you want to hack code and learn about operating system, you will like Basekernel. If you are looking for a new OS to run on your laptop, then this is not what you want.

This project is led by Prof. Douglas Thain at the University of Notre Dame. A variety of students have contributed to the code, including Jack Mazanec, Douglas Smith, Ethan Williams, Jon Westhoff, and Kevin Wern.

To learn more, see the Basekernel Wiki.

Quick Start Instructions

If you are building on a Linux-X86 machine and have the QEMU virtual machine installed:

git clone
cd basekernel
qemu-system-i386 -cdrom basekernel.iso

And you should see something like this:

After some initial boot messages, you will see the kernel shell prompt. This allows you to take some simple actions before running the first user level program. For example, read the boot messages to see which atapi unit the cdrom is mounted on. Then, use the mount command to mount the cdrom filesystem on that unit:

mount atapi 2 cdromfs

Use the list command to examine the root directory:

list /

And use the run command to run a program:

run /bin/saver.exe

Cross-Compiling Instructions

If you are building on any other type of machine, you will probably need to build a cross-compiler using and then edit Makefile.config to use the cross compiler binaries, then execute make to create basekernel.iso

You can’t perform that action at this time.