We are announcing the upcoming deprecation of QEMU as a virtualization option for Docker Desktop on Apple Silicon Macs. After serving as our legacy virtualization solution during the early transition to Apple Silicon, QEMU will be fully deprecated 90 days from today, on July 14, 2025. This deprecation does not affect QEMU\u2019s role in emulating non-native architectures for multi-platform builds. By moving to Apple Virtualization Framework or Docker VMM, you will ensure optimal performance.<\/p>\n
Our telemetry shows that a very small percentage of users are still using the QEMU option. We\u2019ve maintained QEMU support for backward compatibility, but both Docker VMM and Apple Virtualization Framework now offer:<\/p>\n
Significantly better performance<\/p>\n
Improved stability<\/p>\n
Enhanced compatibility with macOS updates<\/p>\n
Better integration with Apple Silicon architecture<\/p>\n
If you\u2019re currently using QEMU as your Virtual Machine Manager (VMM) on Docker Desktop for Mac:<\/p>\n
Your current installation will continue to work normally during the 90-day transition period<\/p>\n
After July 1, 2025, Docker Desktop releases will automatically migrate your environment to Apple Virtualization Framework<\/p>\n
You\u2019ll experience improved performance and stability with the newer virtualization options<\/p>\n
The migration process will be smooth and straightforward:<\/p>\n
Users on the latest Docker Desktop release will be automatically migrated to Apple Virtualization Framework after the 90-day period<\/p>\n
During the transition period, you can manually switch to either Docker VMM (our fastest option for Apple Silicon Macs) or Apple Virtualization Framework through Settings > General > Virtual Machine Options<\/p>\n
For 30 days after the deprecation date, the QEMU option will remain available in settings for users who encounter migration issues<\/p>\n
After this extended period, the QEMU option will be fully removed<\/p>\n
Note:<\/strong> This deprecation does not affect QEMU\u2019s role in emulating non-native architectures for multi-platform builds.<\/p>\n We recommend proactively switching to one of our newer VMM options before the automatic migration:<\/p>\n Update to the latest version<\/a> of Docker Desktop for Mac<\/p>\n Open Docker Desktop Settings > General<\/p>\n Under \u201cChoose Virtual Machine Manager (VMM)\u201d select either:<\/p>\n Docker VMM (BETA) \u2013 Our fastest option for Apple Silicon Macs<\/p>\n Apple Virtualization Framework \u2013 A mature, high-performance alternative<\/p>\n If you have questions or encounter any issues during migration, please:<\/p>\n Visit our documentation<\/a><\/p>\n Reach out to us via GitHub issues<\/a><\/p>\nWhat You Should Do Now<\/strong><\/h2>\n
Questions or Concerns?<\/strong><\/h2>\n