Docker-OSX is a containerized solution that enables users to run macOS virtual machines within Docker containers with near-native performance using KVM virtualization. The project is maintained by Sick.Codes and builds upon upstream projects including OSX-KVM by kholia, KVM-OpenCore by thenickdude, and the OpenCore bootloader from the acidanthera team. The repository is written primarily in Shell and distributed through Docker Hub at sickcodes/docker-osx.
The project supports multiple macOS versions spanning from older systems like High Sierra and Mojave through current releases including Catalina, Big Sur, Monterey, Ventura, Sonoma, Sequoia, and Tahoe. This broad version coverage allows users to conduct security research and testing across different macOS generations. The Docker images are available with pre-built tags for each macOS version, enabling quick deployment without requiring manual installation.
A key feature of Docker-OSX is X11 forwarding support, which allows graphical display of the macOS virtual machine on Linux and Windows hosts. The project also implements iPhone USB passthrough functionality through two methods: VFIO for desktop systems and usbfluxd for laptop and portable setups. The usbfluxd approach converts USB connections to network-based connections, making it compatible with various hardware configurations. Users can connect iPhones and iPads to the virtualized macOS environment for testing and development purposes.
The repository emphasizes use cases in security research, CI/CD automation, and cross-platform development. Users can leverage Docker-OSX for iMessage security research, iOS development testing, and macOS-specific application testing on Linux and Windows infrastructure. The project includes optimization tools through the linked osx-optimizer repository, which provides methods to disable spotlight indexing, skip GUI login screens, and disable updates to improve container performance.
GitGenius activity data shows the repository maintains active engagement with a median issue and pull request response latency of 4.9 hours and a mean latency of 842.2 hours. The primary maintainer sickcodes has logged 216 tracked events, with additional contributors Otus9051 and marcellodesales each contributing 13 events. The most frequently applied issue labels are bug with 5 occurrences, enhancement with 4 occurrences, and following upstream developments with 2 occurrences, indicating the project actively tracks and integrates upstream changes.
The repository overlaps with contributors from microsoft/vscode, velero-io/velero, and vmware-tanzu/velero, suggesting cross-pollination with other infrastructure and development tooling projects. Docker-OSX maintains community engagement through an active Discord server at discord.gg/sickchat and Telegram channel at t.me/sickcodeschat, providing spaces for users to ask questions and share ideas. The project includes comprehensive documentation with video setup tutorials and detailed instructions for advanced features like SSH access, file sharing via sshfs, and storage optimization by moving Docker directories to external block storage or NFS systems.
