How to Install macOS on VMware: A Step-by-Step Guide

Introduction to Virtualizing macOS

Why Run macOS on VMware?

Developers, QA engineers, and hobbyists often need a macOS environment but don’t own a Mac. VMware Workstation (or Player) lets you spin up a full‑featured macOS instance on a Windows or Linux workstation, giving you access to Xcode, Safari, and Apple‑only APIs without buying additional hardware.

Understanding the Legal and Technical Constraints

Apple’s End‑User License Agreement (EULA) allows macOS to run only on Apple‑branded hardware. Installing macOS on a non‑Apple host via virtualization technically breaches that clause, especially for commercial deployments. The act of virtualization itself is not illegal, but the license may be violated if you use the VM for profit or in a multi‑device environment.

Beyond licensing, macOS expects specific hardware identifiers (SMBIOS, board‑id, serial) that ordinary VMware VMs lack. Without proper spoofing, services such as iMessage, iCloud, and the App Store reject the guest. The guide covers those tweaks.

Prerequisites and System Requirements

Hardware Requirements for Smooth Performance

• CPU: Intel Core i7/i9 (8th gen or newer) **or** AMD Ryzen 5/7 with VT‑x/AMD‑V support.
• RAM: Minimum 8 GB; 16 GB recommended for macOS Sonoma/Sequoia.
• Storage: SSD with at least 150 GB free; use a fixed‑size virtual disk to avoid fragmentation.
• Graphics: GPU that supports DirectX 11 (or higher) for 3D acceleration.

Essential Software: VMware Workstation and macOS ISO

Download the latest stable VMware Workstation 17.x for Windows 11 or Linux Ubuntu 22.04. The free Workstation Player works, but it lacks snapshot capabilities.

Obtain a genuine macOS installer. The easiest method in 2026 is the macrecovery.py script from the macOS‑Simple‑ISO project, which pulls the official Recovery‑OS files directly from Apple’s CDN and builds a bootable ISO.

The Role of the VMware Unlocker Tool

VMware blocks macOS as a guest on non‑Mac hosts. The VMware Unlocker patches vmwarebase.dll (Windows) or vmware-vmx (Linux) to add “darwin” to the supported guest list and injects a minimal darwin.iso containing VMware Tools for macOS.

Two main options exist in 2026:

• Manual Unlocker – the classic script from the BDisp fork on GitHub.
• Auto‑Unlocker – a Python‑based wrapper that detects your VMware version and applies the correct patch automatically.

Both work, but the manual version gives you full visibility of what files are altered.

Step-by-Step Walkthrough: Installing macOS

Preparing the VMware Unlocker

1. Close all running instances of VMware.
2. Open a terminal (PowerShell as Administrator on Windows or sudo bash on Linux).
3. Clone the unlocker repository:

git clone https://github.com/BDisp/VMware-Workstation-Unlocker.git
cd VMware-Workstation-Unlocker

4. Run the installer script. On Windows:

.\unlocker.bat

On Linux:

sudo ./unlocker.sh

The script backs up the original binaries and replaces them. Verify the patch succeeded by launching VMware and checking that “Apple macOS 13” appears in the OS list.

Creating a New Virtual Machine Configuration

1. Open VMware Workstation and click File → New Virtual Machine.
2. Choose “Typical (recommended)”.
3. Select “I will install the operating system later”.
4. From the OS dropdown, pick “Apple macOS 13” (or the version you plan to install).
5. Name the VM “macOS‑Sonoma‑VM” and store it on your SSD.

Configuring CPU, RAM, and Disk Space

• Processor: 4 cores (or more) with “Virtualize Intel VT‑x/EPT” (or “AMD‑V/RVI”) enabled.
• Memory: 8192 MB minimum; 16384 MB for heavy Xcode builds.
• Hard Disk: Add a new Fixed size** 120 GB** virtual disk (VDI or VMDK). Fixed size prevents the host’s file system from fragmenting as the VM grows.
• Network: Use NAT for simplicity; switch to Bridged if you need the VM to appear as a separate device on your LAN.

Booting from the macOS ISO and Disk Utility Setup

1. Right‑click the VM → Settings → CD/DVD (SATA). Choose “Use ISO image file” and browse to the macOS ISO you generated.
2. Check “Connect at power on”.
3. Power on the VM. The macOS installer will launch automatically.
4. When the installer asks where to install, open Disk Utility**. Select the virtual disk, click “Erase”, choose APFS (recommended for Sonoma/Sequoia), and confirm.

Completing the macOS Installation Process

1. Close Disk Utility and return to the installer. Choose the newly created APFS volume as the target.
2. Proceed with the installation. The VM will restart a few times; each time, make sure the ISO remains attached until the installer finishes.
3. When the macOS setup assistant appears, you can create a local user account. Skip iCloud activation for now; we’ll handle it later.
4. Log in to the desktop. The first login may be slow as macOS finalizes the installation.

Post-Installation Optimization and Best Practices

Installing VMware Tools for Graphics Acceleration

VMware Tools for macOS are included in the darwin.iso that the Unlocker adds. To install:

1. From the macOS menu bar, choose Virtual Machine → Install VMware Tools.
2. macOS will mount the ISO automatically. Open the mounted volume and run Install VMware Tools.app.
3. After the installer finishes, reboot the VM.

Tools enable 3‑D acceleration, dynamic screen resizing, shared clipboard, and time sync.

Optimizing VMX Files for Better Performance

Edit the VM’s .vmx file (right‑click → “Open VM directory”, then open macOS‑Sonoma‑VM.vmx in a text editor). Add or modify the following lines:

# Enable 3D acceleration
svga.autodetect = "TRUE"
svga.vramSize = "134217728" # 128 MB VRAM

# Spoof SMBIOS to avoid iMessage/App Store issues
board-id = "Mac-7BA5B2D9E42DDD94"
smbios.reflectHost = "FALSE"
serialNumber = "C02XXXXXDV7J"
MLB = "Mac-7BA5B2D9E42DDD94"
ROM = "0x00ff0f0f"

# Enable multiple cores
cpuid.coresPerSocket = "4"
hypervisor.cpuid.v0 = "FALSE"

# Improve disk I/O
disk.EnableUUID = "TRUE"
scsi0:0.present = "TRUE"
scsi0:0.fileName = "macOS-Sonoma-VM.vmdk"

Replace the placeholder identifiers with unique values generated by a tool such as GenSMBIOS. Using distinct identifiers prevents Apple from flagging multiple VMs as the same device.

Managing Snapshots for System Stability

Immediately after a successful installation, take a clean snapshot:

1. VM → Snapshot → Take Snapshot.
2. Name it “Clean‑Install‑2026”.
3. Use this baseline before installing Xcode, third‑party tools, or making kernel tweaks. If something breaks, revert to the snapshot with a single click.

Common Mistakes and Troubleshooting

Fixing the “Apple Logo” Boot Loop

The loop usually indicates a missing or mismatched SMBIOS entry. Open the .vmx file and verify that board-id, serialNumber, MLB, and ROM are present and unique. After editing, power off the VM, delete the .nvram file, and start again.

Resolving Mouse and Keyboard Input Issues

If the cursor jumps or the keyboard lags, ensure VMware Tools are installed. Additionally, enable “USB 3.0” in the VM’s USB controller settings and add a “USB Tablet” device to improve pointer precision.

Handling Virtualization Technology (VT‑x) Errors

When VMware refuses to power on the VM and reports “Virtualization is not supported”, check the BIOS/UEFI:

1. Reboot the host and enter firmware setup (usually Del or F2).
2. Locate “Intel VT‑x” or “AMD‑V” and set it to Enabled.
3. Also enable “Execute Disable Bit” (XD) and “Trusted Execution” if present.
4. Save changes and boot Windows/Linux again.

Who Is This Setup Best For?

User Profile / Target Persona	Recommended Choice / Approach	Key Reason & Benefits
Beginner Developer	Workstation Player + Manual Unlocker + 8 GB RAM, 4‑core CPU	Low cost, simple UI, enough resources for Xcode basics and Swift Playgrounds.
Power User / QA Engineer	Workstation Pro + Auto‑Unlocker + 16 GB RAM, 8‑core CPU, Fixed 120 GB disk	Snapshots, cloning, and advanced networking let you test multiple macOS versions side‑by‑side.
Budget Hunter	Free VMware Player + Community‑built macOS ISO + 4‑core CPU, 8 GB RAM	Zero licensing cost; acceptable for occasional UI checks or script testing.
Enterprise Team	MacStadium‑hosted macOS VMs or on‑premise Pro with dedicated SSD array, 32 GB RAM, 12‑core CPU	Compliance‑ready environment, centralized management, and legal macOS hardware backing.