Reading the repo
Opening the box…
Reading the repo
Opening the box…
Assembly instructions
From-scratch x86 terminal OS kernel. Custom shell and file system (GFS). Still in early development.
Saved setup from 1 min ago
Will it work on macOS?
Install: qemu-system-x86, grub-file, grub-pc-bin, xorriso, mtools, gcc, build-essential.
git clone https://github.com/pagecoy/gumball-os.git
cd gumball-os
chmod +x build.sh # or make it runnable on your OS
./build.sh
qemu-system-i386 -cdrom gumball.iso
Have fun!
Then run bash setup.sh. It stops at the first error and is safe to run again. Servers and tests aren't started; it lists them at the end. Read it first.
Needs Git: xcode-select --install
git clone https://github.com/pagecoy/gumball-os.git cd gumball-os
In the maintainers' order. Do the README instructions above first — they cover steps outside the terminal.
chmod +x build.sh # or make it runnable on your OS ./build.sh qemu-system-i386 -cdrom gumball.iso
No reports for macOS yet.
GitManual AI Agent reads the 2 key files and writes a step-by-step guide for macOS. Once written, it's saved for everyone.