HELP WANTED: Fixing Boot Issues for SafeOS

[ajm19826]

Body

I have an operating system called SafeOS, and is unable to fix the boot issue. Booting into it results into a faulty screen. Any help would be appreciated.
Repository: https://github.com/houselearning/safeos-0.0.96/

Guidelines

• I have read and understood this category's guidelines before making this post.

[thangsauce]

Hi ajm19826! A faulty screen during boot can come from several things (graphics initialization, framebuffer issues, or boot configuration). Since SafeOS is still early-stage, a few checks might help narrow it down.

1. Check the boot environment
   Are you running SafeOS on real hardware, a VM (VirtualBox/VMware/QEMU), or an emulator?
   Some hobby OS projects rely on specific framebuffer modes that don’t work in all environments.

2. Try a different VM or display adapter
   If you're using a VM:
   In VirtualBox, try switching the graphics controller (e.g., VBoxVGA ↔ VMSVGA).
   In QEMU, try booting with a standard VGA device:

qemu-system-x86_64 -vga std -cdrom safeos.iso

Graphics mode mismatches often cause garbled screens.

3. Verify the ISO or build
   If you built it yourself, try rebuilding:

make clean
make

Then recreate the boot image.

4. Check bootloader output
   Sometimes the issue occurs right after the bootloader switches video modes. If possible, check:

bootloader configuration

framebuffer initialization code

5. Look for kernel logs
   If the system supports serial output, try running it with serial logging to see where it fails.