diff --git a/docs/environment-overrides.md b/docs/environment-overrides.md
new file mode 100644
index 000000000..bd78cf3ee
--- /dev/null
+++ b/docs/environment-overrides.md
@@ -0,0 +1,55 @@
+# Environment variables override
+
+If you want to override environment variables for any component in the operator
+deployment, you can do so by adding a `overrides:` section 
+
+example:
+
+```
+  kind: QuayRegistry
+  metadata:
+    name: quay37
+  spec:
+    configBundleSecret: config-bundle-secret
+    components:
+      - kind: objectstorage
+        managed: false
+      - kind: route
+        managed: true
+      - kind: mirror
+        managed: true
+        overrides:
+          env:
+            - name: DEBUGLOG
+              value: "true"
+            - name: HTTP_PROXY
+              value: quayproxy.qe.devcluster.openshift.com:3128
+            - name: HTTPS_PROXY
+              value: quayproxy.qe.devcluster.openshift.com:3128
+            - name: NO_PROXY
+              value: svc.cluster.local,localhost,quay370.apps.quayperf370.perfscale.devcluster.openshift.com
+      - kind: tls
+        managed: false
+      - kind: clair
+        managed: true
+        overrides:
+          env:
+            - name: HTTP_PROXY
+              value: quayproxy.qe.devcluster.openshift.com:3128
+            - name: HTTPS_PROXY
+              value: quayproxy.qe.devcluster.openshift.com:3128
+            - name: NO_PROXY
+              value: svc.cluster.local,localhost,quay370.apps.quayperf370.perfscale.devcluster.openshift.com
+      - kind: quay
+        managed: true
+        overrides:
+          env:
+            - name: DEBUGLOG
+              value: "true"
+            - name: NO_PROXY
+              value: svc.cluster.local,localhost,quay370.apps.quayperf370.perfscale.devcluster.openshift.com
+            - name: HTTP_PROXY
+              value: quayproxy.qe.devcluster.openshift.com:3128
+            - name: HTTPS_PROXY
+              value: quayproxy.qe.devcluster.openshift.com:3128
+```