1 files changed, 119 insertions, 0 deletions
diff --git a/docs/getting-started/machines/qemu.md b/docs/getting-started/machines/qemu.md
new file mode 100644
index 0000000..7bd14c0
--- /dev/null
+++ b/docs/getting-started/machines/qemu.md
@@ -0,0 +1,119 @@
+# Building the AGL Demo Platform for QEMU
+
+To build the QEMU version of the AGL demo platform use machine **qemux86-64** along with features **agl-demo** and **agl-devel**:
+
+```bash
+source meta-agl/scripts/aglsetup.sh -f -m qemux86-64 agl-demo agl-devel
+bitbake agl-demo-platform
+```
+
+By default, the build will produce a compressed *vmdk* image in **tmp/deploy/images/qemux86-64/agl-demo-platform-qemux86-64.vmdk.xz**
+
+## Deploying the AGL Demo Platform for QEMU
+
+### Prepare an image for boot
+
+Decompress the **agl-demo-platform-qemux86-64.vmdk.xz** image to prepare it for boot.
+
+#### Linux
+
+```bash
+cd tmp/deploy/images/qemux86-64
+xz -d agl-demo-platform-qemux86-64.vmdk.xz
+```
+
+#### Windows
+
+Download [7-Zip](http://www.7-zip.org/) and select **agl-demo-platform-qemux86-64.vmdk.xz** to be decompressed.
+
+## Boot an image
+
+### QEMU
+
+#### Install QEMU
+
+**Note**: if an AGL crosssdk has been created, it will contain a qemu binary for the host system. This SDK qemu binary has no graphics support and cannot currently be used to boot an AGL image.
+
+*Arch*:
+
+```bash
+sudo pacman -S qemu
+```
+
+*Debian/Ubuntu*:
+
+```bash
+sudo apt-get install qemu-system-x86
+```
+
+*Fedora*:
+
+```bash
+sudo yum install qemu-kvm
+```
+
+#### Boot QEMU
+
+Boot the **agl-demo-platform-qemux86-64.vmdk** image in qemu with kvm support:
+
+```bash
+qemu-system-x86_64 -enable-kvm -m 2048 \
+    -hda agl-demo-platform-qemux86-64.vmdk \
+    -cpu kvm64 -cpu qemu64,+ssse3,+sse4.1,+sse4.2,+popcnt \
+    -vga virtio -show-cursor \
+    -device virtio-rng-pci \
+    -serial mon:stdio -serial null \
+    -soundhw hda \
+    -net nic,vlan=0 \
+    -net user,hostfwd=tcp::2222-:22
+```
+
+### VirtualBox
+
+#### Install VirtualBox
+
+Download and install [VirtualBox](https://www.virtualbox.org/wiki/Downloads) 5.2.0 or later.
+
+#### Boot VirtualBox
+
+Boot the **agl-demo-platform-qemux86-64.vmdk** image in VirtualBox:
+
+* Start VirtualBox
+* Click **New** to create a new machine
+  * Enter **AGL QEMU** as the *Name*
+  * Select **Linux** as the *Type*
+  * Select **Other Linux (64-bit)** as the *Version*
+  * Set *Memory size* to **2 GB**
+  * Click **Use an existing virtual hard disk file** under *Hard disk*
+        * Navigate to and select the **agl-demo-platform-qemux86-64.vmdk** image
+* Ensure that the newly created **AGL QEMU** machine is highlighted and click **Start**
+
+### VMWare Player
+
+#### Install VMWare Player
+
+Download and install [VMWare Player](https://www.vmware.com/products/player/playerpro-evaluation.html)
+
+#### Boot VMWare Player
+
+Boot the **agl-demo-platform-qemux86-64.vmdk** image in VMWare Player:
+
+* Start VMWare Player
+* Select **File** and **Create a New Virtual Machine**
+  * Select **I will install the operating system later** and click **Next**
+  * Select **Linux** as the *Guest Operating System*, **Other Linux 3.x kernel 64-bit** as the *Version*, and click **Next**
+  * Enter **AGL QEMU** as the *Name* and click **Next**
+  * Leave *disk capacity settings* unchanged and click **Next**
+  * Click **Finish**
+* Select/highlight **AGL QEMU** and click **Edit virtual machine settings**
+  * Select/highlight **Memory** and click **2 GB**
+  * Select/highlight **Hard Disk (SCSI)** and click **Remove**
+  * Click **Add**
+    * Select **Hard Disk** and click **Next**
+    * Select **SCSI (Recommended)** and click **Next**
+    * Select **Use an existing virtual disk** and click **Next**
+    * Browse and select the **agl-demo-platform-qemux86-64.vmdk** image
+    * Click **Finish**
+    * Click **Keep Existing Format**
+  * Click **Save**
+* Ensure that the newly created **AGL QEMU** machine is highlighted and click **Power On**