The sickcodes/docker-osx repository provides a powerful and flexible solution for running macOS virtual machines inside Docker containers, leveraging KVM virtualization for near-native performance. Its primary purpose is to enable macOS environments on non-Apple hardware, particularly for security research, CI/CD pipelines, development, and testing. The project is maintained by Sick.Codes and builds upon upstream projects like OSX-KVM and KVM-OpenCore, utilizing the OpenCore bootloader for enhanced compatibility and functionality.
Docker-OSX supports a wide range of macOS versions, from High Sierra (10.13) through to the latest releases such as Sonoma (14), Sequoia (15), and Tahoe (16). Users can easily launch containers for specific macOS versions by setting environment variables and using pre-built Docker images. The repository also offers options for using custom disk images, enabling advanced use cases such as automated SSH access and headless operation. For those needing a pre-installed environment, the 'auto' image provides a ready-to-use Catalina installation.
A standout feature is X11 forwarding, which allows graphical macOS applications to be displayed on Linux or Windows hosts. This is particularly useful for developers and researchers who require GUI access. The repository also provides detailed instructions for sharing files and directories between the host and the macOS guest, recommending SSHFS for secure and efficient file transfer.
One of the unique capabilities of Docker-OSX is iPhone USB passthrough. The repository documents two methods: VFIO for desktop PCs and usbfluxd for laptops and other systems. The usbfluxd approach enables network-style USB passthrough, allowing iOS devices to be recognized by the macOS VM for development and testing purposes. Comprehensive guides and video tutorials are available to assist users in setting up these features.
Performance optimization is addressed through integration with the osx-optimizer project, which provides scripts to disable unnecessary macOS services and features, such as Spotlight indexing and login screen wallpapers, thereby improving VM responsiveness. The repository also includes guidance on increasing disk space by relocating Docker's storage directory to external drives or network storage, catering to users with large storage requirements.
Docker-OSX is designed to be accessible to a wide audience, including Windows users, with specific notes and instructions for cross-platform compatibility. The project fosters an active community, offering support via Discord, Telegram, and other channels. Contributions are encouraged, and credits are given to upstream maintainers and contributors.
Technically, Docker-OSX offers multiple container images tailored to different needs, including versions for each macOS release, pre-installed environments, and images for custom disk usage. The setup process is well-documented, with clear instructions for initial configuration, running containers, and troubleshooting. The repository is frequently updated to support new macOS releases and features, ensuring ongoing relevance and utility.
In summary, sickcodes/docker-osx is a comprehensive solution for running macOS in Docker containers, providing robust support for multiple macOS versions, advanced features like USB passthrough and X11 forwarding, performance optimizations, and a strong community. It is an invaluable tool for researchers, developers, and anyone needing macOS environments on non-Apple hardware.
