From 843342d972a0d638a711d1967173264df530ce3b Mon Sep 17 00:00:00 2001
From: =?UTF-8?q?Christian=20Ma=CC=88der?= <cma@nine.ch>
Date: Mon, 16 Oct 2017 13:33:12 +0200
Subject: [PATCH] Document the use of the build variable

---
 README.md          | 27 +++++++++++++++++++++++++++
 docker-compose.yml |  4 ++--
 2 files changed, 29 insertions(+), 2 deletions(-)

diff --git a/README.md b/README.md
index 7ade7ce..8cbef06 100644
--- a/README.md
+++ b/README.md
@@ -47,6 +47,33 @@ To ensure this, compare the output of `docker --version` and `docker-compose --v
 
 You can configure the app using environment variables. These are defined in `netbox.env`.
 
+## Version
+
+The `docker-compose.yml` file is prepared to run a specific version of Netbox.
+To use this feature, set the environment-variable `VERSION` before launching `docker-compose`, as shown below.
+`VERSION` may be set to the name of
+[any tag of the `ninech/netbox` Docker image](https://hub.docker.com/r/ninech/netbox/tags/).
+
+```
+$ export VERSION=v2.2.1
+$ docker-compose pull netbox
+$ docker-compose up -d
+```
+
+You can also build a specific version of the Netbox image. This time, `VERSION` indicates any valid
+[Git Reference](https://git-scm.com/book/en/v2/Git-Internals-Git-References) declared on
+[the Netbox Github repository](https://github.com/digitalocean/netbox/releases).
+Most commonly you will specify a tag name or a branch name.
+
+```
+$ export VERSION=develop
+$ docker-compose build --no-cache netbox
+$ docker-compose up -d
+```
+
+Hint: If you're building a specific version by tag name, the `--no-cache` argument is not strictly necessary.
+This can increase the build speed if you're just adjusting the config, for example.
+
 ## Rebuilding & Publishing images
 
 `./build.sh` is used to rebuild the Docker image:
diff --git a/docker-compose.yml b/docker-compose.yml
index 117925f..d34b591 100644
--- a/docker-compose.yml
+++ b/docker-compose.yml
@@ -4,8 +4,8 @@ services:
         build:
           context: .
           args:
-            - BRANCH=${BRANCH-master}
-        image: ninech/netbox:${BRANCH-latest}
+            - BRANCH=${VERSION-master}
+        image: ninech/netbox:${VERSION-latest}
         depends_on:
         - postgres
         env_file: netbox.env