{"id":13405893,"url":"https://github.com/foxlet/macOS-Simple-KVM","last_synced_at":"2025-03-14T10:31:58.234Z","repository":{"id":34936485,"uuid":"182644013","full_name":"foxlet/macOS-Simple-KVM","owner":"foxlet","description":"Tools to set up a quick macOS VM in QEMU, accelerated by KVM.","archived":false,"fork":false,"pushed_at":"2024-04-04T15:48:46.000Z","size":6915,"stargazers_count":13636,"open_issues_count":365,"forks_count":1140,"subscribers_count":246,"default_branch":"master","last_synced_at":"2024-10-29T15:04:35.436Z","etag":null,"topics":["bigsur","catalina","hackintosh","high-sierra","kvm","linux","macos","mojave","qemu","virtual-machine"],"latest_commit_sha":null,"homepage":"","language":"Shell","has_issues":true,"has_wiki":null,"has_pages":null,"mirror_url":null,"source_name":null,"license":null,"status":null,"scm":"git","pull_requests_enabled":true,"icon_url":"https://github.com/foxlet.png","metadata":{"files":{"readme":"README.md","changelog":null,"contributing":null,"funding":".github/FUNDING.yml","license":null,"code_of_conduct":null,"threat_model":null,"audit":null,"citation":null,"codeowners":null,"security":null,"support":null,"governance":null,"roadmap":null,"authors":null,"dei":null,"publiccode":null,"codemeta":null},"funding":{"github":"foxlet","custom":["https://www.paypal.com/cgi-bin/webscr?cmd=_donations\u0026business=QFXXKKAB2B9MA\u0026item_name=macOS-Simple-KVM","https://commerce.coinbase.com/checkout/96dc5777-0abf-437d-a9b5-a78ae2c4c227"]}},"created_at":"2019-04-22T07:25:20.000Z","updated_at":"2024-10-29T05:21:28.000Z","dependencies_parsed_at":"2022-07-04T11:24:03.697Z","dependency_job_id":"ecac1929-efee-40c2-ac3d-5b30579248ea","html_url":"https://github.com/foxlet/macOS-Simple-KVM","commit_stats":{"total_commits":69,"total_committers":15,"mean_commits":4.6,"dds":0.2753623188405797,"last_synced_commit":"527588d5a25c232fa82bfa079cdb6771568f3d95"},"previous_names":[],"tags_count":0,"template":false,"template_full_name":null,"repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/foxlet%2FmacOS-Simple-KVM","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/foxlet%2FmacOS-Simple-KVM/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/foxlet%2FmacOS-Simple-KVM/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/foxlet%2FmacOS-Simple-KVM/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/foxlet","download_url":"https://codeload.github.com/foxlet/macOS-Simple-KVM/tar.gz/refs/heads/master","host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":243119548,"owners_count":20239321,"icon_url":"https://github.com/github.png","version":null,"created_at":"2022-05-30T11:31:42.601Z","updated_at":"2022-07-04T15:15:14.044Z","host_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub","repositories_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories","repository_names_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repository_names","owners_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners"}},"keywords":["bigsur","catalina","hackintosh","high-sierra","kvm","linux","macos","mojave","qemu","virtual-machine"],"created_at":"2024-07-30T19:02:15.122Z","updated_at":"2025-03-14T10:31:58.213Z","avatar_url":"https://github.com/foxlet.png","language":"Shell","readme":"# macOS-Simple-KVM\nDocumentation to set up a simple macOS VM in QEMU, accelerated by KVM.\n\nBy [@FoxletFox](https://twitter.com/foxletfox), and the help of many others. Find this useful? You can donate [on Coinbase](https://commerce.coinbase.com/checkout/96dc5777-0abf-437d-a9b5-a78ae2c4c227) or [Paypal!](https://www.paypal.com/cgi-bin/webscr?cmd=_donations\u0026business=QFXXKKAB2B9MA\u0026item_name=macOS-Simple-KVM).\n\nNew to macOS and KVM? Check [the FAQs.](docs/FAQs.md)\n\n## Getting Started\nYou'll need a Linux system with `qemu` (3.1 or later), `python3`, `pip` and the KVM modules enabled. A Mac is **not** required. Some examples for different distributions:\n\n```\nsudo apt-get install qemu-system qemu-utils python3 python3-pip  # for Ubuntu, Debian, Mint, and PopOS.\nsudo pacman -S qemu python python-pip python-wheel  # for Arch.\nsudo xbps-install -Su qemu python3 python3-pip   # for Void Linux.\nsudo zypper in qemu-tools qemu-kvm qemu-x86 qemu-audio-pa python3-pip  # for openSUSE Tumbleweed\nsudo dnf install qemu qemu-img python3 python3-pip # for Fedora\nsudo emerge -a qemu python:3.4 pip # for Gentoo\n```\n\n## Step 1\nRun `jumpstart.sh` to download installation media for macOS (internet required). The default installation uses Catalina, but you can choose which version to get by adding either `--high-sierra`, `--mojave`, or `--catalina`. For example:\n```\n./jumpstart.sh --mojave\n```\n\u003e Note: You can skip this if you already have `BaseSystem.img` downloaded. If you have `BaseSystem.dmg`, you will need to convert it with the `dmg2img` tool.\n\n## Step 2\nCreate an empty hard disk using `qemu-img`, changing the name and size to preference:\n```\nqemu-img create -f qcow2 MyDisk.qcow2 64G\n```\n\nand add it to the end of `basic.sh`:\n```\n    -drive id=SystemDisk,if=none,file=MyDisk.qcow2 \\\n    -device ide-hd,bus=sata.4,drive=SystemDisk \\\n```\n\u003e Note: If you're running on a headless system (such as on Cloud providers), you will need `-nographic` and `-vnc :0 -k en-us` for VNC support.\n\nThen run `basic.sh` to start the machine and install macOS. Remember to partition in Disk Utility first!\n\n## Step 2a (Virtual Machine Manager)\n1. If instead of QEMU, you'd like to import the setup into Virt-Manager for further configuration, just run `sudo ./make.sh --add`.\n2. After running the above command, add `MyDisk.qcow2` as storage in the properties of the newly added entry for VM.\n\n## Step 2b (Headless Systems)\nIf you're using a cloud-based/headless system, you can use `headless.sh` to set up a quick VNC instance. Settings are defined through variables as seen in the following example. VNC will start on port `5900` by default.\n```\nHEADLESS=1 MEM=1G CPUS=2 SYSTEM_DISK=MyDisk.qcow2 ./headless.sh\n```\n\n## Step 3\n\nYou're done!\n\nTo fine-tune the system and improve performance, look in the `docs` folder for more information on [adding memory](docs/guide-performance.md), setting up [bridged networking](docs/guide-networking.md), adding [passthrough hardware (for GPUs)](docs/guide-passthrough.md), tweaking [screen resolution](docs/guide-screen-resolution.md), and enabling sound features.\n","funding_links":["https://github.com/sponsors/foxlet","https://www.paypal.com/cgi-bin/webscr?cmd=_donations\u0026business=QFXXKKAB2B9MA\u0026item_name=macOS-Simple-KVM","https://commerce.coinbase.com/checkout/96dc5777-0abf-437d-a9b5-a78ae2c4c227"],"categories":["Shell","HarmonyOS","Shell (473)","其他__大数据","macos","Uncategorized"],"sub_categories":["Windows Manager","网络服务_其他","Uncategorized"],"project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Ffoxlet%2FmacOS-Simple-KVM","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Ffoxlet%2FmacOS-Simple-KVM","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Ffoxlet%2FmacOS-Simple-KVM/lists"}