Skip to content

Instantly share code, notes, and snippets.

@rguiscard
Last active July 29, 2026 06:40
Show Gist options
  • Select an option

  • Save rguiscard/24bbda34fecebd90e1aa72f8e93068a9 to your computer and use it in GitHub Desktop.

Select an option

Save rguiscard/24bbda34fecebd90e1aa72f8e93068a9 to your computer and use it in GitHub Desktop.

HaikuOS on MacBook M5

This is a journal of running HaikuOS on Macbook M5. It should apply generally to all aarch64 platform.

Qemu

Although HaikuOS-aarch64 does work, it is not yet good enough. Therefore, I will use qemu-system-X86_64 to run the x86_64 version of HaikuOS. Even without KVM, it runs reasonally smooth and takes only 10-20% of CPU.

Create disk (qcow2)

$ qemu-img create -f qcow2 haiku.qcow2 30G

First run for installation

qemu-system-x86_64 -m 8G -hda haiku.qcow2 -cdrom haiku-r1beta5-x86_64-anyboot.iso -boot d

It will boot the install disk. Installation is quite straight forward. During partition, select the new disk and format it BeFS. Quit partition and close the qemu after installation.

Run HaikuOS from installed disk

qemu-system-x86_64 -m 8G -hda haiku.qcow2

That's it. Very easy.

ssh

        -netdev user,id=net1,hostfwd=tcp::2222-:22 \
        -device virtio-net-pci,netdev=net1

Allow root login.

Then run ssh -p 2222 user@localhost.

Troubleshooting

Screen and text too small

Adjust screen size at Preferences > Screen. Adjust text size in Preferences > Appearance. Need to reboot to show full effect.

library version mismatch

Try run pkgman full-sync to update everything.

mouse pointer out of sync

If mouse pointer in Haiku moves differently from the host one, try add this line to qemu:

-usbdevice tablet

Haiku nightly may not boot

Use virto-scsi instead:

    -device virtio-scsi-pci,id=scsi0 \
    -drive if=none,id=drive0,file=haiku_disk.qcow2,cache=writeback \
    -device scsi-hd,drive=drive0,bus=scsi0.0 \
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment