From 24f1f971680312a765a415dbcaae7a883e3caa76 Mon Sep 17 00:00:00 2001
From: Tommy Brunn <tommy.brunn@klarna.com>
Date: Fri, 2 Jun 2017 16:40:46 +0200
Subject: [PATCH] Document Docker usage

---
 README.md | 29 +++++++++++++++++++++++++++++
 1 file changed, 29 insertions(+)

diff --git a/README.md b/README.md
index 3968142..a054bc5 100644
--- a/README.md
+++ b/README.md
@@ -88,6 +88,35 @@ Total issues:
 
 Or something else, you can find all other `gixy` arguments with the help command: `gixy --help`
 
+## Docker usage
+
+Gixy is available as a Docker image [from the Docker hub](https://hub.docker.com/r/yandex/gixy/). To
+use it, mount the configuration that you want to analyse as a volume and provide the path to the
+configuration file when running the Gixy image.
+```
+$ docker run --rm -v `pwd`/nginx.conf:/etc/nginx/conf/nginx.conf yandex/gixy /etc/nginx/conf/nginx.conf
+```
+
+If you have an image that already contains your nginx configuration, you can share the configuration
+with the Gixy container as a volume.
+```
+$  docker run --rm --name nginx -d -v /etc/nginx
+nginx:alpinef68f2833e986ae69c0a5375f9980dc7a70684a6c233a9535c2a837189f14e905
+
+$  docker run --rm --volumes-from nginx yandex/gixy /etc/nginx/nginx.conf
+
+==================== Results ===================
+No issues found.
+
+==================== Summary ===================
+Total issues:
+    Unspecified: 0
+    Low: 0
+    Medium: 0
+    High: 0
+
+```
+
 # Contributing
 Contributions to Gixy are always welcome! You can help us in different ways:
   * Open an issue with suggestions for improvements and errors you're facing;