OSX-KVM

Overview

Ubuntu 15.10 running on i5-6500 CPU.

Detected project type: Shell.

This repository was migrated from upstream source github.com/shafiqalibhai/OSX-KVM and is preserved here for archival, reference, or continued local development.

At a glance

• Default branch: master
• Visibility: public
• Size: 1.9 MB
• Created: 2026-04-27
• Last updated: 2026-04-27
• Stars / Forks / Open issues: 0 / 0 / 0

Languages

Language	Bytes	Share
Shell	28,292 bytes	87.3%
C	3,219 bytes	9.9%
Makefile	887 bytes	2.7%

Repository structure

• pbzx-src/
• screenshots/
• .gitignore (55 B)
• boot.sh (1,469 B)
• create_osx_install_iso.sh (26,823 B)
• enoch_rev2795_boot (454,144 B)
• enoch_rev2839_boot (441,856 B)
• macOS-libvirt.xml (2,150 B)
• networking-qemu-kvm-howto.txt (532 B)
• notes.md (1,611 B)
• org.chameleon.boot.plist (415 B)
• pbzx (89,812 B)
• pbzx.md5sum (39 B)
• pbzx.sha256sum (71 B)
• README.md (2,755 B)

Getting started

Clone the repository:

git clone https://forgejo.deployview.com/ssa/OSX-KVM.git
cd OSX-KVM

Installation

git clone https://forgejo.deployview.com/ssa/OSX-KVM.git
cd OSX-KVM

Usage

Refer to the source files in this repository for entry points and intended usage. Update this section with concrete examples once they are established.

Original README

The content below is preserved from the previous README. Headings have been demoted so they don't compete with the new top-level sections.

Host System Details

Ubuntu 15.10 running on i5-6500 CPU.

Fedora 24 running on i5-6500 CPU.

Tested with QEMU 2.4.1 and QEMU 2.5.

ISO Creation

• Download OS X El Capitan or macOS Sierra installer from Apple App Store.

• Run the ISO creation script, making sure to use 'sudo'.

• Copy the ISO from your Mac to your KVM machine.

Installation

See boot.sh file for an alternate to the following virsh method.

virsh --connect qemu:///system define macOS-libvirt.xml

• Redefine HDD/DVD sources in virt-manager.

• Start the VM in virt-manager and hit return in the console window.

• After booting, the initial language selection should show up.

• After selecting the language, fire-up the Disk Utility ...

• ... and initialize the new harddisk.

• After disk initialization, open a terminal window (in the Utilities menu) and recursively copy the /Extra folder to the newly initialized target volume using

   cp -av /Extra "/Volumes/NewVolumeName"
  

• When done, quit Terminal.

• Now, you can continue with the installation as usual

• When finished, the VM will reboot automatically and the first time setup continues as usual.

Debugging

Host machine may need the following tweak for this to work,

echo 1 > /sys/module/kvm/parameters/ignore_msrs

Type the following in the bootloader if the guest VM fails to boot (some older ISO images may require this),

"KernelBooter_kexts"="Yes" "CsrActiveConfig"="103"

Credits

• Fritz Elfert (felfert) - cleanups, better documentation, and nicer ISO creation script

• Ian McDowell (IMcD23) - more documentation, and better ISO creation script

• voobscout - libvirt XML file

References

• https://github.com/Karlson2k/k2k-OSX-Tools

• https://macosxvirtualmachinekvm.wordpress.com/guide-mac-os-x-10-11-el-capitan-vm-on-unraid/

• http://www.contrib.andrew.cmu.edu/~somlo/OSXKVM/

• http://bit.do/bootable

Contributing

Contributions are welcome. The typical workflow is:

1. Open an issue describing the change you'd like to make.
2. Fork the repository (or create a feature branch if you have write access).
3. Commit your changes with clear, descriptive messages.
4. Open a pull request against the master branch.

Please follow the existing code style and include tests or reproduction steps where relevant.

License

No LICENSE file is currently present in this repository. Treat the contents as all rights reserved by the author until an explicit license is added. If you intend to share or accept contributions, consider adding an OSI-approved license such as MIT, Apache-2.0, or GPL-3.0.

Repository

• Browse: https://forgejo.deployview.com/ssa/OSX-KVM
• Clone (HTTPS): https://forgejo.deployview.com/ssa/OSX-KVM.git
• Clone (SSH): ssh://git@forgejo.deployview.com:30143/ssa/OSX-KVM.git
• Upstream / origin: github.com/shafiqalibhai/OSX-KVM

---

This README was generated automatically based on repository metadata, contents, and any prior README content. Edit any section above to add project-specific detail.