diff --git a/.env.dist b/.env.dist
new file mode 100644
index 0000000..78fad9e
--- /dev/null
+++ b/.env.dist
@@ -0,0 +1,16 @@
+# GITHUB_OCELOT_REF affects the publish workflow
+# GITHUB_OCELOT_REF is a ref (branch, tag, hash) of the ocelot repository
+# if this value is not set the github ref just built in the triggering workflow is used.
+# if this workflow is triggered by push to master instead of a build-trigger,
+# the `master` branch of the ocelot repo is used.
+# if you set it to `GITHUB_OCELOT_REF=master` unnessecary builds can occur.
+# It is recommended to not set it rather then to set it to `master`
+#GITHUB_OCELOT_REF=b2.4.0-351
+
+# DOCKERHUB_OCELOT_TAG applies to the deploy workflow
+# DOCKERHUB_OCELOT_TAG is a dockerhub tag for the configured (values.yaml) docker images
+# if this value is not set the version just built in the triggering workflow is used.
+# using `DOCKERHUB_OCELOT_TAG=latest` is the default behaviour of the Kubernetes Chart,
+# but its inaccurate if two workflows are running at the same time.
+# It is recommended to not set it rather then to set it to `latest`
+#DOCKERHUB_OCELOT_TAG=2.4.0-351
\ No newline at end of file