diff --git a/README.md b/README.md index e70716f..4835944 100644 --- a/README.md +++ b/README.md @@ -12,17 +12,19 @@ - Create an ARMY using `docker commit` - XFVB HEADLESS (use vnc) +### Pull Requests Welcome! + ![Running mac osx in a docker container](/running-mac-inside-docker-qemu.png?raw=true "OSX KVM DOCKER") Run Mac in a Docker container! Run near native OSX-KVM in Docker! X11 Forwarding! Author: Sick.Codes https://sick.codes/ & https://twitter.com/sickcodes -Based: https://github.com/kholia/OSX-KVM && the great guy [@kholia](https://twitter.com/kholia) +PR & Contributor Credits: https://github.com/sickcodes/Docker-OSX/blob/master/CREDITS.md -Credits: https://github.com/sickcodes/Docker-OSX/blob/master/CREDITS.md +Upstream: https://github.com/kholia/OSX-KVM && the great guy [@kholia](https://twitter.com/kholia) -Upstream Credits: OSX-KVM project among many others: https://github.com/kholia/OSX-KVM/blob/master/CREDITS.md +Upstream Credits (OSX-KVM project) among many others: https://github.com/kholia/OSX-KVM/blob/master/CREDITS.md Docker Hub: https://hub.docker.com/r/sickcodes/docker-osx @@ -30,13 +32,14 @@ Docker Hub: https://hub.docker.com/r/sickcodes/docker-osx [Run iOS in a Docker with Docker-eyeOS](https://github.com/sickcodes/Docker-eyeOS) - [https://github.com/sickcodes/Docker-eyeOS](https://github.com/sickcodes/Docker-eyeOS) -Pull requests, suggestions very welcome! +# Run Docker-OSX ```bash docker pull sickcodes/docker-osx:latest -docker run --device /dev/kvm \ +docker run \ + --device /dev/kvm \ --device /dev/snd \ -v /tmp/.X11-unix:/tmp/.X11-unix \ -e "DISPLAY=${DISPLAY:-:0.0}" \ @@ -48,14 +51,21 @@ docker run --device /dev/kvm \ # need more RAM and SSH on localhost -p 50922? -docker run --device /dev/kvm \ - -e "DISPLAY=${DISPLAY:-:0.0}" \ +``` + +# Run but allow SSH + +```bash +docker run \ + --device /dev/kvm \ --device /dev/snd \ -e RAM=4 \ -p 50922:10022 \ -v /tmp/.X11-unix:/tmp/.X11-unix \ + -e "DISPLAY=${DISPLAY:-:0.0}" \ sickcodes/docker-osx:latest +# turn on SSH after you've installed OSX in the "Sharing" settings. ssh fullname@localhost -p 50922 ``` @@ -63,7 +73,8 @@ ssh fullname@localhost -p 50922 # Requirements: KVM on the host Need to turn on hardware virtualization in your BIOS, very easy to do. -Then have QEMU on the host if you haven't already: +Then have QEMU on the host if you haven't already + ```bash # ARCH sudo pacman -S qemu libvirt dnsmasq virt-manager bridge-utils flex bison iptables-nft edk2-ovmf @@ -72,7 +83,7 @@ sudo pacman -S qemu libvirt dnsmasq virt-manager bridge-utils flex bison iptable sudo apt install qemu qemu-kvm libvirt-clients libvirt-daemon-system bridge-utils virt-manager # CENTOS RHEL FEDORA -sudo yum install libvirt qemu-kvm -y +sudo yum install libvirt qemu-kvm # then run sudo systemctl enable libvirtd.service @@ -83,37 +94,9 @@ sudo modprobe kvm # reboot ``` -# How to Enable Network Forwarding - -Allow ipv4 forwarding for bridged networking connections: - -This is not required for LOCAL installations and may cause containers behind [VPN's to leak host IP](https://sick.codes/cve-2020-15590/). - -If you are connecting to a REMOTE Docker-OSX, e.g. a "Mac Mini" in a datacenter, then this may boost networking: - -```bash -# enable for current session -sudo sysctl -w net.ipv4.ip_forward=1 - -# OR -# sudo tee /proc/sys/net/ipv4/ip_forward <<< 1 - -# enable permanently -sudo touch /etc/sysctl.conf - -sudo tee -a /etc/sysctl.conf <