README.md

osx-on-docker

Run macOS on top of Docker with near-native performance with ease

Requirements

• KVM
• Docker
• docker-compose or Docker compose plugin
• X11

List of supported macOS variant

• Ventura [34Gi]
• Monterey [?Gi]
• Big Sur [?Gi]

How to use it?

• Clone this repository

$ git clone https://github.com/telkomdev/osx-on-docker

• Choose macOS variant, ex: ventura

$ export variant="ventura" \
    && cd osx-on-docker \
    && cd ${variant} \
    && ./run.sh

• The script will automatically download macOS base image & run it in qemu

Default username & password

• username: admin
• password: letmein

Mounting hostshare volume

• On your macOS

$ sudo -S mount_9p hostshare

• hostshare will be mounted on /Volume/hostshare in macOS

Common Issues

Error "gtk initialization failed"

• Arch Linux

$ sudo pacman -S xorg-xhost

• Debian, Ubuntu, Linux Mint

$ sudo apt update \
    && sudo apt install -y x11-xserver-utils \
    && xhost +

• RHEL, Centos, Fedora

$ sudo yum install xorg-x11-server-utils

Links & Resources

• DockerOSX: https://github.com/sickcodes/Docker-OSX
• Installing Xcode: https://github.com/RobotsAndPencils/xcodes