About this project

Docker-OSX packages macOS virtual machines as Docker containers, built on top of QEMU and KVM, so a macOS guest can be launched with a single `docker run` command on a Linux host. The project describes near-native performance, X11 forwarding, SSH access on port 50922, optional VNC, folder sharing (for example via sshfs), and USB passthrough including iPhone devices through usbfluxd or VFIO. It is positioned primarily for security research on macOS from Linux or Windows, and for CI/CD style automation of macOS environments. Supported guest releases listed in the README include High Sierra (10.13), Mojave (10.14), Catalina (10.15), Big Sur (11), Monterey (12), Ventura (13), Sonoma (14), Sequoia (15) and Tahoe (16), selected through the SHORTNAME environment variable. Several image variants are documented: standard images, an `auto` pre-installed Catalina image, a `naked` variant that accepts a user-supplied disk image, and a `naked-auto` variant that also supports automated login and command execution. Images are published on Docker Hub under sickcodes/docker-osx. Requirements noted by the project include a KVM-capable x86_64 host with virtualization enabled in firmware, and substantial disk space (roughly 20 GB minimum, more with Xcode, and about 50 GB for the auto image). The README also mentions a Kubernetes Helm chart, a serial-number generator for iMessage research, and an optimizer project for speeding up instances by disabling indexing, updates and login-screen effects. Documentation for security researchers and GPU acceleration are listed as TODO items. The project is licensed under GPL v3+ and credits upstream OSX-KVM, KVM-OpenCore and OpenCore work.