OSX

OSX inside a Docker container.

Features

• KVM acceleration
• Image downloader
• Web-based viewer

Usage

Via Docker Compose:

services:
  osx:
    image: dockurr/osx
    container_name: osx
    environment:
      VERSION: "ventura"
    devices:
      - /dev/kvm
    cap_add:
      - NET_ADMIN
    ports:
      - 8006:8006
      - 5900:5900/tcp
      - 5900:5900/udp
    stop_grace_period: 2m

Via Docker CLI:

docker run -it --rm -p 8006:8006 --device=/dev/kvm --cap-add NET_ADMIN --stop-timeout 120 dockurr/osx

Via Kubernetes:

kubectl apply -f kubernetes.yml

FAQ

• How do I use it?

  Very simple! These are the steps:

  • Start the container and connect to port 8006 using your web browser.

  • Select macOs Base System with your keyboard to begin the installation.

  • Select Disk Utility and then select the QEMU HARDDISK Media that has the size you specified.

  • Click Erase to format the disk, you can give it any name you want.

  • When finished, go back by closing the window and then proceed the installation by clicking Reinstall macOS <version>.

  • When prompted where to install it, select the disk you created.

  • Once you see the desktop, your OSX installation is ready for use.

  Enjoy your brand new machine, and don't forget to star this repo!

• How do I select the OSX version?

  By default, Ventura will be installed. But you can add the VERSION environment variable to your compose file, in order to specify an alternative OSX version to be downloaded:

  environment:
    VERSION: "ventura"
  

  Select from the values below:

  Value	Version	Size
  high-sierra	High Sierra	? GB
  mojave	Mojave	? GB
  catalina	Catalina	? GB
  big-sur	Big Sur	? GB
  monterey	Monterey	? GB
  ventura	Ventura	3 GB
  sonoma	Sonoma	? GB

Acknowledgements

Special thanks to OSX-KVM and qemu-docker. This would not exist without their invaluable work.

Disclaimer

The product names, logos, brands, and other trademarks referred to within this project are the property of their respective trademark holders. This project is not affiliated, sponsored, or endorsed by Apple Inc.