diff --git a/README.md b/README.md
index f9212223..5f756ec7 100644
--- a/README.md
+++ b/README.md
@@ -1,5 +1,20 @@
 # x
 
+## HAProxy deployment
+
+```
+cd /vagrant
+python cli.py deploy haproxy_deployment/haproxy-deployment.yaml
+```
+
+or from Python shell:
+
+```
+from x import deployment
+
+deployment.deploy('/vagrant/haproxy_deployment/haproxy-deployment.yaml')
+```
+
 ## Usage:
 
 Creating resources: