YAK – Yet Another Kernel

Version 1.1.0 · released 6 November 2026 · x86-64, runs in QEMU · GPL-3.0-or-later

The YAK shell running in a QEMU window, showing the output of uname, cpu, netinfo, ps and df
The YAK shell in QEMU: uname, cpu, netinfo, ps and df.

What it is

YAK is a small x86-64 operating system written from scratch in Rust. It's made for learning how a kernel works: by reading it, running it, testing it and changing it. It runs in QEMU, with BIOS and UEFI.

Everything is our own code. The only crates are limine (boot protocol) and spin (locks).

YAK is a hobby and learning project. It is not a Linux replacement, not POSIX-compatible, not a desktop system and not a driver collection for real hardware. There is a course: build a kernel, chapter by chapter. Its 20 chapters go from the first boot over interrupts, memory, threads on every core, a SATA driver and FAT32 up to the first program in ring 3; each one is a complete project with its own tests. For now the course ends there.

What's in it

AreaWhat YAK does
BootLimine boot protocol, BIOS and UEFI, higher-half kernel
CPUOwn GDT/TSS/IDT, local APIC and I/O APIC, every core from the ACPI MADT started via INIT/SIPI, SMEP/SMAP, x87/SSE/AVX state per thread
MemoryBitmap frame allocator, 4-level paging, guarded kernel stacks, kernel heap, demand-paged user heaps and stacks
SchedulingPreemptive round-robin SMP scheduler, kernel and user threads, futexes, sleeping mutexes
ProcessesRing 3, one address space per process, ELF loader, 53 syscalls, signals, pipes, environment variables
StoragePCI, AHCI SATA driver with MSI, sector cache, FAT32 with long file names – persistent across reboots
Networke1000, Ethernet/ARP/IPv4/ICMP/UDP/TCP, DHCP, DNS client, wget and httpd
User space/bin/sh with pipes, redirection, scripts, if/while/for/case, functions, $(...) and jobs; a full-screen editor and 37 more programs

Try it

You don't need to build anything. Every release from 1.0 on has ready-made files on the download page: the ISO (kernel and bootloader, boots with BIOS and UEFI), the FAT32 disk image with /bin and sample files, the start script run-yak.sh and SHA256SUMS.

Put the files of one release into a folder, install QEMU (package qemu-system-x86 on Fedora, Debian and Ubuntu), then run:

sha256sum -c SHA256SUMS     # the files arrived intact
./run-yak.sh                # QEMU window; the serial console is in this terminal
./run-yak.sh --headless     # no window (Ctrl+A X quits QEMU)
./run-yak.sh --uefi /usr/share/OVMF/OVMF_CODE_4M.fd   # through UEFI

On Fedora the UEFI firmware is at /usr/share/edk2/ovmf/OVMF_CODE.fd. The disk image is unpacked on the first start and keeps what you write to it. Delete yak-1.1.0-disk.img to start fresh.

Things to try in the shell: help, ls /bin, cat /README.txt | wc, ps, cpu, ping 10.0.2.2, edit notes.txt.

The keyboard layout is German (QWERTZ) by default.

Build it yourself

To change YAK you need the source. Rust comes from rustup; the exact nightly compiler is pinned in rust-toolchain.toml. You also need QEMU, xorriso, dosfstools, mtools, make, gcc, binutils, git and python3 (and OVMF for UEFI).

git clone https://github.com/FreakySneaky787/yak-kernel.git
cd yak-kernel
rustup toolchain install   # reads rust-toolchain.toml
make deps                  # checks the host tools
make run                   # build everything and boot in QEMU
make check                 # all tests

The first build downloads the Limine binaries into vendor/limine.

Supported environment

YAK runs in QEMU only. “Supported” means make check passes there, locally and in CI on every push.

Supported (tested)Not supported / untested
EmulatorQEMU, machine q35, TCG (no KVM needed)KVM, other emulators, real hardware
FirmwareBIOS (SeaBIOS) and UEFI (OVMF)
CPU1 to 4 cores, CPU models max and qemu64More than 4 cores
RAM256 MiB (default); BIOS works down to 24 MiB, UEFI needs 160 MiB
DevicesAHCI SATA disk with FAT32, e1000, PS/2 keyboard, COM1, framebufferUSB, NVMe, virtio, other network cards
HostLinux: Ubuntu 24.04 and FedoramacOS, Windows

Documentation

The whole documentation is on its own website as a book with navigation and search: freakysneaky787.github.io/yak-kernel.

Tests

License

YAK is free software under the GNU General Public License, version 3 or later (GPL-3.0-or-later). Anyone may use, study, change and share it; whoever distributes it or a changed version must pass on the source code under the same license.

The bundled Terminus font keeps its SIL Open Font License, and the Limine bootloader keeps its own license.