Reading the repo
Opening the box…
Reading the repo
Opening the box…
How to install on Windows
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 Windows?
winget install Git.Git) or WSL2 (wsl --install).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 powershell -ExecutionPolicy Bypass -File .\setup.ps1. 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: winget install Git.Git
git clone https://github.com/pagecoy/gumball-os.git cd gumball-os
Run these in Git Bash (installed with Git) or WSL — not PowerShell. Do the README instructions above first.
chmod +x build.sh # or make it runnable on your OS ./build.sh qemu-system-i386 -cdrom gumball.iso
The steps run shell scripts (.sh). Use Git Bash (winget install Git.Git) or WSL2 (wsl --install).
No reports for Windows yet.
GitManual AI Agent reads the 2 key files and writes a step-by-step guide for Windows. Once written, it's saved for everyone.