diff --git a/docs/installation/notes.md b/docs/installation/notes.md
new file mode 100644
index 0000000..d43ac8e
--- /dev/null
+++ b/docs/installation/notes.md
@@ -0,0 +1,11 @@
+# Notes
+
+## Kubernetes setup
+
+If you setup RustiCal with Kubernetes and call the deployment `rustical`
+Kubernetes will by default expose some environment variables starting with `RUSTICAL_`
+that will be rejected by RustiCal.
+So for now the solutions are either not calling the deployment `rustical` or setting
+`enableServiceLinks: false`, see <https://kubernetes.io/docs/tutorials/services/connect-applications-service/#accessing-the-service>.
+
+For the corresponding issue see <https://github.com/lennart-k/rustical/issues/122>
diff --git a/mkdocs.yml b/mkdocs.yml
index 86cdb0a..1c24950 100644
--- a/mkdocs.yml
+++ b/mkdocs.yml
@@ -68,6 +68,7 @@ nav:
   - Installation:
       - installation/index.md
       - Configuration: installation/configuration.md
+      - Notes: installation/notes.md
   - Client Setup: setup/client.md
   - OpenID Connect: setup/oidc.md
   - Developers: