diff --git a/docs/installation/install_oas.rst b/docs/installation/install_oas.rst
index 956eb929a7645513a33864670e60286f8674ae63..34802fcccc972d92436cf31c6fe624753913c90b 100644
--- a/docs/installation/install_oas.rst
+++ b/docs/installation/install_oas.rst
@@ -58,7 +58,7 @@ Prerequisites
 Copy the file ``install/.flux.env.example`` to your cluster dir
 ``clusters/oas.example.org/.flux.env``. This file contains the last bit of
 information you need to configure. You **have to** configure the following
-values. The rest are optional. 
+values. The rest are optional.
 
 - ``ip_address``: The IP address of your cluster
 - ``domain``: The FQDN of your cluster
diff --git a/install/.flux.env.example b/install/.flux.env.example
index a52a4079a7155af41a5237ff374c69e6e70ae709..d67c951cc8acccdcd3b53e2656ada58f5916f780 100755
--- a/install/.flux.env.example
+++ b/install/.flux.env.example
@@ -1,3 +1,7 @@
+# This file contains variables that will be used in Kubernetes manifests.
+# Replace the values to make sense for your setup. The values should not be
+# quoted (correct: a=b, incorrect: a="b").
+
 # IP address of the cluster
 ip_address=1.2.3.4
 # FQDN of the cluster