OSX-KVM README

The project's README from github.com/kholia/OSX-KVM. As one markdown file: README.md.

Note

This README.md documents the process of creating a Virtual Hackintosh system.

Note: All blobs and resources included in this repository are re-derivable (all instructions are included!).

:green_heart: Looking for commercial support with this stuff? I am available over email for a chat for commercial support options only. Note: Project sponsors get access to the Private OSX-KVM repository, and direct support.

Struggling with Content Caching stuff? We can help.

Working with Proxmox and macOS:

Yes, we support offline macOS installations now - see this document 🎉

Contributing Back

This project can always use your help, time and attention. I am looking for help (pull-requests!) with the following work items:

Requirements

Note: Older AMD CPU(s) are known to be problematic but modern AMD Ryzen processors work just fine (even for macOS Sonoma).

Installation Preparation

Installation

Headless macOS

Setting Expectations Right

Nice job on setting up a Virtual Hackintosh system! Such a system can be used for a variety of purposes (e.g. software builds, testing, reversing work), and it may be all you need, along with some tweaks documented in this repository.

However, such a system lacks graphical acceleration, a reliable sound sub-system, USB 3 functionality and other similar things. To enable these things, take a look at our notes. We would like to resume our testing and documentation work around this area. Please reach out to us if you are able to fund this area of work.

It is possible to have 'beyond-native-apple-hw' performance but it does require work, patience, and a bit of luck (perhaps?).

Post-Installation

The "secret" Apple OSK string is widely available on the Internet. It is also included in a public court document available here. I am not a lawyer but it seems that Apple's attempt(s) to get the OSK string treated as a trade secret did not work out. Due to these reasons, the OSK string is freely included in this repository.

Please review the 'Legality of Hackintoshing' documentation bits from Dortania's OpenCore Install Guide.

Gabriel Somlo also has some thoughts on the legal aspects involved in running macOS under QEMU/KVM.

You may also find this 'Announcing Amazon EC2 Mac instances for macOS' article interesting.

Note: It is your responsibility to understand, and accept (or not accept) the Apple EULA.

Note: This is not legal advice, so please make the proper assessments yourself and discuss with your lawyers if you have any concerns (Text credit: Dortania)

Motivation

My aim is to enable macOS based educational tasks, builds + testing, kernel debugging, reversing, and macOS security research in an easy, reproducible manner without getting 'invested' in Apple's closed ecosystem (too heavily).

These Virtual Hackintosh systems are not intended to replace the genuine physical macOS systems.

Personally speaking, this repository has been a way for me to 'exit' the Apple ecosystem. It has helped me to test and compare the interoperability of Canon CanoScan LiDE 120 scanner, and Brother HL-2250DN laser printer. And these devices now work decently enough on modern versions of Ubuntu (Yay for free software). Also, a long time back, I had to completely wipe my (then) brand new MacBook Pro (Retina, 15-inch, Late 2013) and install Xubuntu on it - as the OS X kernel kept crashing on it!

Backstory: I was a (poor) student in Canada in a previous life and Apple made my work on cracking Apple Keychains a lot harder than it needed to be. This is how I got interested in Hackintosh systems.

OSX-KVM (kholia/OSX-KVM)

Searching Database…

23.7K ·GitHub
Что это такое?Скрипты и конфигурация OpenCore для запуска macOS в виртуальной машине под QEMU/KVM на хосте с Linux, с поддержкой свежих версий macOS, таких как Monterey, Ventura и Sonoma.
Это готовое приложение или набор скриптов, которые я запускаю сам?Это не приложение: набор shell-скриптов, конфигов загрузки и заметок. Вы клонируете репозиторий, готовите установочный образ и запускаете виртуальную машину через OpenCore-Boot.sh, который QEMU загружает с помощью OpenCore.
Как пройти путь с нуля до работающего рабочего стола macOS?Mac не нужен: установите QEMU и другие пакеты, склонируйте репозиторий, запустите шаг fetch, чтобы скачать BaseSystem.dmg, конвертируйте его в BaseSystem.img, создайте виртуальный жёсткий диск на быстром SSD, затем запустите OpenCore-Boot.sh и установите macOS.
Какое железо и ПО нужны на моей машине для этого?Современный 64-битный дистрибутив Linux (Ubuntu 24.04 LTS или новее), QEMU 8.2.2+ и процессор с Intel VT-x или AMD SVM. Для Sierra и новее нужен SSE4.1, для Ventura и новее — AVX2; старые процессоры AMD вызывают проблемы, а современные Ryzen работают отлично.
Чем я жертвую по сравнению с настоящим Mac?Из коробки нет графического ускорения, надёжной звуковой подсистемы и USB 3. Производительность выше нативной возможна, но требует усилий, терпения и удачи; нужные твики описаны в заметках репозитория.
Можно ли запустить это на сервере без монитора?Да — используйте прилагаемый скрипт boot-macOS-headless.sh, а в заметках о сети объясняется, как настроить входящий доступ по SSH или VNC для удалённой работы.
Можно ли установить macOS полностью без интернета?Да. В README заявлена поддержка офлайн-установки macOS и дана ссылка на документ с описанием метода OpenCore-ISO.
Законно ли запускать macOS таким способом, и есть ли лицензия?Файла лицензии нет; автор включает строку OSK от Apple, утверждая, что она свободно доступна в публичном судебном документе, а вопросы законности отсылает к материалам Dortania. Принимать (или не принимать) EULA Apple — ваша ответственность.
Могу ли я пробросить свою видеокарту в виртуальную машину?Проброс видеокарт и других устройств рассмотрен в отдельных заметках репозитория. Нюанс: современные видеокарты NVIDIA работают только до High Sierra включительно, на более новых версиях macOS — нет.
Для чего люди используют такие виртуальные машины с macOS?По словам автора: учебные задачи, сборка и тестирование программ, отладка ядра XNU, реверс-инжиниринг и исследование безопасности macOS — воспроизводимо и без техники Apple. Он подчёркивает, что такие системы не предназначены заменять настоящие Mac.
Почему автор создал этот проект?Он хотел простой воспроизводимый способ заниматься исследованием безопасности и тестированием macOS, не погружаясь в закрытую экосистему Apple. Будучи бедным студентом в Канаде, он столкнулся с тем, что Apple усложняла его работу над взломом Apple Keychains, и Hackintosh-системы стали для него способом выйти из этой экосистемы.
Какие версии macOS поддерживаются?Скрипт OpenCore-Boot.sh описан как работающий со всеми свежими версиями macOS, а шаг fetch позволяет выбрать, какую скачать. Выделены Monterey, Ventura и Sonoma, а в темах репозитория среди поддерживаемых целей указаны также Catalina и Tahoe.
Есть ли кто-то, кто поможет, если настройка не получится?Бесплатная поддержка намеренно ограничена: автор отвечает только на коммерческие (платные) запросы, чтобы избежать спама в issues. Спонсоры проекта получают доступ к приватному репозиторию и прямую поддержку.
Creator
kholia
Size
165.2 MB
Stars
23.7K
Updated
CommitJan 26
Age
10y
Commits · 90 Days