How sickcodes/docker-osx works
Docker-OSX packages macOS virtual machines for use in Docker. The main workflow is a user launching a container configured for a macOS release, with the container providing the VM runtime and host-facing access such as display forwarding. The repository also includes a macOS installer fetcher, customization assets, and a Helm deployment chart. The README and excerpts support the fetcher’s catalog/download behavior; runtime wiring and several deployment details are not sampled, so those links are marked unverified rather than asserted.
Main entry points: Chart.yaml Helm chart · README.md Docker launch · Dockerfile Container images · fetch-macOS.py Installer fetcher
Components 22
Container launch
- Docker launch
README.md - Container images
Dockerfile - Auto images
Dockerfile.auto - Naked images
Dockerfile.naked - Naked auto
Dockerfile.naked-auto
Virtual machine
- macOS VM runtime
Dockerfile - Display and devices
README.md
Installer and customization
- Installer fetcher
fetch-macOS.py - Custom boot configs
custom/config-custom.plist - Legacy boot configs
custom/config-legacy.plist - Boot disk generator
custom/generate-specific-bootdisk.sh - Machine values
custom/generate-unique-machine-values.sh - OpenCore image
custom/opencore-image-ng.sh - Kernel patch helper
scripts/apply_appleid_kernelpatch.py
Cluster deployment
- Helm chart
helm/Chart.yaml - VM deployment
helm/templates/deployment.yaml - Persistent disk
helm/templates/data-pvc.yaml - Cluster service
helm/templates/service.yaml - Ingress route
helm/templates/ingress.yaml
Other components
- Docker user
- Apple software catalogs
- Cluster operator
Connections 10
- Docker user → Docker launch: runs image
README.md - Docker launch → Container images: selects image
- Container images → macOS VM runtime: starts VM
- macOS VM runtime → Display and devices: offers access
- Installer fetcher → Apple software catalogs: fetches catalogs
fetch-macOS.py - Cluster operator → Helm chart: deploys chart
- Helm chart → VM deployment: renders deployment
- Helm chart → Persistent disk: defines storage
- Helm chart → Cluster service: defines service
- Helm chart → Ingress route: defines ingress