1 files changed, 41 insertions, 1 deletions

diff --git a/README.md b/README.md
index 789cbff..8eb7815 100644
--- a/README.md
+++ b/README.md
@@ -1,2 +1,42 @@
 # Docker-OSX
-Mac in Docker! Run near native OSX-KVM in Docker! X11 Forwarding!
+
+![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/
+Credits: OSX-KVM project among many others: https://github.com/kholia/OSX-KVM/blob/master/CREDITS.md
+
+```
+docker run --privileged -v /tmp/.X11-unix:/tmp/.X11-unix sickcodes/docker-osx:latest
+```
+
+# Instant OSX-KVM in a BOX!
+This Dockerfile automates the installation of OSX-KVM inside a docker container.
+
+It will build a 32GB Mojave Disk.
+
+You can change the size and version using build arguments (see below).
+
+This file builds on top of the work done by Dhiru Kholia and many others on the OSX-KVM project.
+
+
+# Custom Build
+```
+
+git clone https://github.com/sickcodes/Docker-OSX.git
+
+cd Docker-OSX
+
+docker build -t docker-osx:latest \
+--build-arg VERSION=10.14.6 \
+--build-arg SIZE=200G
+
+docker run --privileged -v /tmp/.X11-unix:/tmp/.X11-unix sickcodes/docker-osx:latest
+
+```
+
+## Todo:
+```
+# persistent disk with least amount of pre-build errands.
+```
\ No newline at end of file