Line endings are enforced by .gitattributes, so a fresh clone on any
platform will check out with LF endings — no manual git config needed.
$ git clone git@github.com:shiro-dev/shiro.git- Docker (with the
docker composeplugin) - A web browser (for the default
make run— Shiro renders inside the container and you view it athttp://localhost:6080/vnc.html).
Everything else — the cross-compiler (binutils + gcc + gdb for i686-elf),
nasm, xorriso, grub-pc-bin, QEMU, and noVNC — lives inside the Docker
image. No host-side installs.
Optional: if you already have
qemu-system-i386on your host,make run-hostskips the VNC layer for a snappier display.
$ make docker-build # one-time, ~20-40 min (toolchain compile, then cached)
$ make run # builds the kernel and boots Shiro in the containerThen open http://localhost:6080/vnc.html?autoconnect=1&resize=scale to see
the running OS. Stop the VM with make stop-vm.