Skip to content

Cherrytree56567/AstralOS

Folders and files

NameName
Last commit message
Last commit date

Latest commit

c21f7f7 · · Feb 22, 2026

History

223 Commits
Feb 17, 2026
Jan 11, 2026
Feb 17, 2026
Feb 17, 2026
Feb 17, 2026
Feb 17, 2026
Feb 17, 2026
Jan 13, 2026
Feb 17, 2026
Jul 4, 2025
Feb 17, 2026
Jan 21, 2025
Jan 21, 2025
Dec 15, 2025
Feb 17, 2026
Feb 17, 2026
Jan 13, 2026
Jan 23, 2025
Feb 17, 2026
Jan 21, 2025
Feb 22, 2026

Repository files navigation

AstralOS

A Simple AMD 64 UEFI EXT4 Operating System made in C and C++.

Banner

Building

If you are using WSL, make sure you use the build with NBD. There is an msi in the root dir with NBD. To build on Windows, install WSL (Windows Subsystem For Linux) and upgrade your distro to WSL 2. Then initialize cmake by running:g:

cmake -B .

To install Dependencies and setup directories run:

cmake --build . --target init

Then Build the Bootloader and Kernel by running:

cmake --build . --target build

To test the build just run

cmake --build . --target run

Testing

If you would like to test the OS. Get the newest release, clone the repo and put the Image in AstralOS.Testing. Make sure you are in the AstralOS git root dir. Then just go inside AstralOS.Testing and run:

sudo qemu-system-x86_64 -machine q35 -cpu qemu64 -m 4G -drive file=AstralOS.qcow2 -drive if=pflash,format=raw,unit=0,file="OVMFbin/OVMF_CODE-pure-efi.fd",readonly=on -drive if=pflash,format=raw,unit=1,file="OVMFbin/OVMF_VARS-pure-efi.fd" -net none

Features

  • Paging
  • GDT
  • IDT
  • Heap Allocator
  • ACPI
  • APIC
  • PCI
  • PCIe (UNTESTED)

Thanks

OSDev Wiki
Poncho for the Poncho OS Paging Setup
Android Bionic LibC
UEFI:NTFS