---

name: docker_osx description: "Run macOS in Docker on Linux with KVM. Use when: user wants to build iOS apps/IPAs, needs macOS environment, wants to compile Apple apps without Mac, or wants to run macOS-only software. NOT for: servers without KVM, low-resource systems (needs 4+ CPU, 8GB RAM), or production macOS deployments. Requires Docker + KVM." homepage: https://github.com/sickcodes/Docker-OSX metadata: openclaw: emoji: 🍎 requires: bins: [docker] kvm: true

Docker-OSX

Run macOS in Docker - build iOS apps on Linux!

Quick Start

start macos        # Boot VM (2-5 min)
status macos       # Check if ready
ssh macos          # Connect
stop macos         # Shutdown

Commands

Connection

• SSH: port 50922, password: alpine
• VNC: port 5900

Building iOS

# In macOS terminal:
xcode-select --install
git clone <repo>
cd repo
xcodegen generate
xcodebuild -project App.xcodeproj -scheme App -configuration Release -destination 'generic/platform=iOS' CODE_SIGN_IDENTITY="" CODE_SIGNING_REQUIRED=NO CODE_SIGNING_ALLOWED=NO build

Errors

Resources

• 4+ CPU cores
• 8GB+ RAM
• 100GB disk