sickcodes/Docker-OSX

Maintainer? Show your league in your README

Card: your league's emblem, from Copper to Legendary

[![bestofgithub](https://bestofgithub.dev/badge/sickcodes/Docker-OSX.svg?style=card)](https://bestofgithub.dev/repo/sickcodes/Docker-OSX)

Flat: fits beside your other badges

[![bestofgithub](https://bestofgithub.dev/badge/sickcodes/Docker-OSX.svg)](https://bestofgithub.dev/repo/sickcodes/Docker-OSX)

Loading README…

Docker-OSX · Follow @sickcodes on Twitter

Docker-OSX now has a Discord server & Telegram!

Click to join the Discord server https://discord.gg/sickchat

Click to join the Telegram server https://t.me/sickcodeschat

Author

Quick Start Docker-OSX

Any questions, ideas, or just want to hang out?

https://discord.gg/sickchat

Catalina (10.15)

Big Sur (11)

Monterey (12)

Ventura (13)

Sonoma (14)

Sequoia (15)

Tahoe (16)

docker build -t docker-osx .

Older Systems

High Sierra

Mojave

Download the image manually and use it in Docker

Share directories, sharing files, shared folder, mount folder

(VFIO) iPhone USB passthrough (VFIO)

(USBFLUXD) iPhone USB -> Network style passthrough OSX-KVM Docker-OSX

Connect to a host running usbfluxd

Make container FASTER using https://github.com/sickcodes/osx-optimizer

Increase disk space by moving /var/lib/docker to external drive, block storage, NFS, or any other location conceivable.

Important notices:

Technical details

Capabilities

Requirements

TODO

Docker

Kubernetes

Support

Small questions & issues

Resolved issues

Feature requests and updates

Professional support

License/Contributing

Other cool Docker/QEMU based projects

Disclaimer

Instructions

Container images

Already set up or just looking to make a container quickly? Check out our quick start or see a bunch more use cases under our container creation examples section.

Initial setup

I'd like to run Docker-OSX on Windows

Additional boot instructions for when you are creating your container

Troubleshooting

Routine checks

Confirm that your CPU supports virtualization

Docker Unknown Server OS error

Use more CPU Cores/SMP

Confirm your user is part of the Docker group, KVM group, libvirt group

Add yourself to the Docker group

Is the docker daemon enabled?

More Questions and Answers

Start the same container later (persistent disk)

I have used Docker-OSX before and want to restart a container that starts automatically

LibGTK errors "connection refused"

Permissions denied error

RAM over-allocation

PulseAudio

Use PulseAudio for sound

PulseAudio debugging

PulseAudio with WSLg

Forward additional ports (nginx hosting example)

Bridged networking

Enable IPv4 forwarding for bridged network connections for remote installations

Share folder with Docker-OSX QEMU macOS

Share Linux NFS Drive into macOS

Share USB Drive into macOS over QEMU

Mount USB Drive (Hotplug/Hot Plug USB)

Mount USB Drive inside macOS at boot Docker OSX

Fedora: enable internet connectivity with a bridged network

Nested Hardware Virtualization

Virtual network adapters

Fast internet connectivity

Slow internet connectivity

CI/CD Related Improvements

Tips for reducing the size of the image

What is `${DISPLAY:-:0.0}`?

What is `-v /tmp/.X11-unix:/tmp/.X11-unix`?