Docker Osx

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.

modbender Updated 12 repo stars

File contents

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

Command Description
start macos Boot macOS VM
stop macos Shutdown VM
status macos Check running
ssh macos Get SSH command
vnc macos Get VNC address
logs macos View logs

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

Error Fix
KVM not available Server needs hardware virtualization
Docker not installed `curl -sSL get.docker.com

Resources

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

modbender/skill-library-mcp/tree/main/data/docker-osx commit 753d528f05

Frequently asked questions

npx skillmds@latest add modbender/docker-osx