sudo ./unlocker.py install
The script will:
Step 1: Close VMware
sudo vmware-installer -u vmware-workstation
# Or just close all VMware windows
Step 2: Extract and run unlocker
cd /tmp
wget https://github.com/paolo-projects/unlocker/archive/refs/tags/3.0.4.tar.gz
tar -xzf 3.0.4.tar.gz
cd unlocker-3.0.4/linux
sudo ./install.sh
Step 3: Restart VMware services
sudo systemctl restart vmware
# or
sudo /etc/init.d/vmware restart
Step 4: Verify Launch VMware Workstation → New VM → Look for “Apple Mac OS X”
To understand why 3.0.4 is effective, you must understand the mechanism VMware uses to block macOS.
When VMware starts a VM, it reads a hidden value called SMBIOS.reflectHost = "TRUE" and cross-references it with the SMBIOS.system-manufacturer string. If that string is not "Apple Inc.", VMware inserts a CPUID check that fails, causing the guest OS to panic with a "This version of Mac OS X is not supported on this platform" error.
VMware Unlocker 3.0.4 performs three surgical modifications: vmware unlocker 3.0.4
The result? macOS installs and boots exactly as it would on a real Mac.
For decades, VMware Workstation (on Windows/Linux) and VMware Fusion (on macOS) have been the gold standards for x86 virtualization. However, users have long faced a significant wall: By default, VMware products do not support installing macOS as a guest operating system on non-Apple hardware (or even on Apple hardware within certain configurations).
This restriction is not a technical limitation but a licensing one. Apple’s End User License Agreement (EULA) states that macOS should only be installed on genuine Apple hardware. Consequently, VMware’s code contains a hardcoded "smc.version = 0" platform identifier that blocks macOS booting on generic PCs.
Enter the VMware Unlocker—a community-developed tool that patches VMware’s virtualization engines to remove these artificial restrictions. Among the various versions released over the years, VMWare Unlocker 3.0.4 stands out as a mature, stable, and widely adopted release. The script will: Step 1: Close VMware sudo
This article dives deep into everything you need to know about VMware Unlocker 3.0.4: what it is, how it works, step-by-step installation guides, compatibility matrices, troubleshooting tips, and legal considerations.
macOS licensing only permits installation on genuine Apple hardware. Using this tool on non-Apple hardware violates Apple’s EULA. This guide is for educational and research purposes only.
After macOS boots, go to VM menu → Install VMware Tools. If the auto-mount fails, manually mount darwin.iso from C:\Program Files (x86)\VMware\VMware Workstation\darwin.iso (Windows) or /usr/lib/vmware/isoimages/darwin.iso (Linux).
# Extract the unlocker
unzip unlocker-3.0.4.zip -d unlocker304
cd unlocker304/linux