3
5
Fork
You've already forked AuroraOS
2
The Nordic Operating System!
  • C 96.7%
  • Shell 1.3%
  • Assembly 1.1%
  • Meson 0.4%
  • C++ 0.2%
  • Other 0.1%
2026年05月29日 22:40:51 +02:00
docs new update: fs rewrite + doxygen integration 2026年05月29日 22:36:37 +02:00
host-recipes new update: fs rewrite + doxygen integration 2026年05月29日 22:36:37 +02:00
initrd refactoring in the kernel and new ports 2026年05月03日 18:04:55 +02:00
kernel new update: fs rewrite + doxygen integration 2026年05月29日 22:36:37 +02:00
limine one repo for everything including ports, multiple fixes, coreutils ported 2026年03月27日 22:41:16 +01:00
meta refactoring in the kernel and new ports 2026年05月03日 18:04:55 +02:00
patches refactoring in the kernel and new ports 2026年05月03日 18:04:55 +02:00
recipes new update: fs rewrite + doxygen integration 2026年05月29日 22:36:37 +02:00
source-recipes refactoring in the kernel and new ports 2026年05月03日 18:04:55 +02:00
.gitignore new update: fs rewrite + doxygen integration 2026年05月29日 22:36:37 +02:00
CONTRIBUTORS.md More fs fixes, fixed documentation. 2026年01月11日 16:53:55 +01:00
cross_file one repo for everything including ports, multiple fixes, coreutils ported 2026年03月27日 22:41:16 +01:00
Doxyfile new update: fs rewrite + doxygen integration 2026年05月29日 22:36:37 +02:00
Jinxfile one repo for everything including ports, multiple fixes, coreutils ported 2026年03月27日 22:41:16 +01:00
LICENSE.md New procfs and devfs, multiple QoL changes and bugfixes. 2026年04月19日 12:28:50 +02:00
limine.conf New procfs and devfs, multiple QoL changes and bugfixes. 2026年04月19日 12:28:50 +02:00
meson.build new update: fs rewrite + doxygen integration 2026年05月29日 22:36:37 +02:00
meson.options one repo for everything including ports, multiple fixes, coreutils ported 2026年03月27日 22:41:16 +01:00
README.md README updated to feature the new doc site. 2026年05月29日 22:40:51 +02:00

Discord - Documentation

Warning

AuroraOS is still in REALLY early development, sometimes it doesn't even boot. Don't let it come near any production environment. Stay safe!


The Nordic Operating System...

Getting Started:

1. Build the OS:

$ git clone https://codeberg.org/aurora-org/AuroraOS.git
$ cd AuroraOS
$ meson setup build
$ meson compile -C build iso

2. Run the OS with QEMU:

$ qemu-system-x86_64 --drive format=raw,file=auroraos.img -serial stdio -no-reboot -d guest_errors,int,pcall,unimp,out_asm -D debug.log

Remove the -monitor stdio and use -nographic to run it just in the terminal.

Advice:
Use meson compile -C build run to build and run the OS.

Building on real hardware... So you are building AuroraOS on real hardware, I wouldn't recommend it but here is how.

$ meson compile -C build iso

Burn the auroraos.iso onto a bootable USB, this might work or not.. Good luck!

Note


Please see our official documentation site for further examples and documentation.

Our goal:

It's not our goal to make the next windows, just learn and practice modern OS developing in modern C and C++....

AI Usage

AI is used in AuroraOS for multiple different reasons, mainly to assist developers with debugging, writing small code snippets and/or speeding up reptetive tasks. This doesn't make AuroraOS some vibe-coded crap. Everything is reviewed and often rewritten by the author. Your pull-request will not be closed if it contains AI generated snippets of code.

Support:

Please email me on Wickslynx@yahoo.com I will respond as soon as possible, updates come regularly.