add recipes

doc/README.md

@@ -19,6 +19,8 @@ Welcome on the Xen Orchestra documentation. This document has multiple purposes,
 
 ## [VM Usage](./vm/README.md)
 
+## [Recipes](./recipes/README.md)
+
 <!--  
 
 This is what's left to do

doc/recipes/README.md

@@ -0,0 +1,5 @@
+# Recipies
+
+The place to find how to do cool things with Xen Orchestra :)
+
+- [Xen Orchestra behind an Apache reverse proxy](apache-reverse.md) (thanks to schn0052 [on our forum](https://xen-orchestra.com/forum/93-apache-reverse-proxy)!)

doc/recipes/apache-reverse.md

@@ -0,0 +1,14 @@
+# Xen Orchestra behind an Apache reverse proxy
+
+As XO-web and XO-server communicates with *WebSockets*, you need to have the `mod_proxy_tunnel` in Apache (please [check the Apache documentation](http://httpd.apache.org/docs/2.4/mod/mod_proxy_wstunnel.html) about it). It's available for Apache 2.4.5 and later.
+
+
+Please use this configuration in this order or it will not work:
+
+```
+ProxyPass /api/ ws://x.x.x.x/api/
+ProxyPassReverse /api/ ws://x.x.x.x/api/
+
+ProxyPass / http://x.x.x.x/
+ProxyPassReverse / http://x.x.x.x/
+```