Claudimon Project Download | Documentation | About
Building Claudimon

You will need an assembler, a freestanding C compiler, GRUB's rescue tool, and an x86 emulator. No real hardware is required.

$ sudo apt install nasm gcc grub-pc-bin grub-common xorriso qemu-system-x86
$ sudo dnf install nasm gcc grub2-tools xorriso qemu-system-x86
# Fedora ships the rescue tool as grub2-mkrescue,
# the Makefile already accounts for this.
$ sudo pacman -S nasm gcc binutils grub xorriso qemu

Build steps

1. Get the source The kernel source lives under claudimon-main/: boot code, kernel sources, headers, and the GRUB config.
2. Build it Assembles the boot stub, compiles every kernel source, links it into a flat binary, wraps it in a bootable ISO with GRUB, and creates a 16MB virtual hard disk for the filesystem.
$ cd claudimon-main
$ make
3. Run it Launches QEMU with the ISO as the boot disc and the virtual disk attached.
$ make run
4. Reset if needed make clean wipes build artifacts. make clean-disk wipes saved files too, useful if the filesystem ever gets into a bad state.
This is a learning kernel, not a daily driver. Claudimon has no memory protection, no partition awareness, and a single hand rolled filesystem with no journaling. Run it in QEMU, or on a spare machine you do not mind wiping, never on a computer with files you care about.