diff --git a/README.md b/README.md
index c5276fd..71a61d9 100644
--- a/README.md
+++ b/README.md
@@ -64,3 +64,38 @@ point.
   ```
   At this point you should be able to follow the same instructions as described
   in https://www.yoctoproject.org/docs/current/yocto-project-qs/yocto-project-qs.html#releases.
+
+Troubleshooting
+---------------
+
+### runqemu - ERROR - TUN control device /dev/net/tun is unavailable; you may need to enable TUN (e.g. sudo modprobe tun)
+
+Add the `slirp` argument to your `runqemu` call to use usermode networking instead of TUN. Example:
+
+    runqemu qemux86 slirp
+
+### runqemu - ERROR - Failed to run qemu: Could not initialize SDL(No available video device) - exiting
+
+Add the `nographic` argument to your `runqemu` call to avoid using SDL. The text output will go to your console. Example:
+
+    runqemu qemux86 nographic
+
+### Accessing core-image-sato GUI via VNC
+
+Since this image has a graphical interface, when SDL is unavailable an alternative to accessing its GUI is via a VNC client. Informing the argument `publicvnc` to `runqemu` will make QEMU setup a VNC server at port 5900.
+
+    runqemu qemux86 slirp publicvnc
+
+But to get to the container's internal port 5900, you must map it to an available host port, for example 20000. Add the `-p` option when starting your container:
+
+    docker run --rm -it -v myvolume:/workdir -p 20000:5900 crops/poky --workdir=/workdir
+
+After running `runqemu`, point your VNC client to `127.0.0.1:20000`.
+
+> Mac users: You must download a third party VNC client. The builtin client available in Finder (Command-K) does not connect to the local host.
+
+### Access running QEMU image via SSH
+
+If your image has an active SSH server, before connecting to it you must map container's port 22 to an available host port, such as 2222. Note that when using the `slirp` argument to `runqemu`, an internal redirect from 2222 to 22 is already in place. In this case you must map the container's 2222 port, not 22. Example:
+
+    docker run --rm -it -v myvolume:/workdir -p 2222:2222 crops/poky --workdir=/workdir