diff --git a/docs/deployment.md b/docs/deployment.md
index b49d2c6..8a743ed 100644
--- a/docs/deployment.md
+++ b/docs/deployment.md
@@ -111,6 +111,17 @@ is often added automatically by your provider.
 
 When the process is complete with `certbot`, restart your server, e.g. `systemctl restart nginx`.
 
+If you see such errors as the following when setting up your deployment:
+
+```
+nginx: [emerg] unknown "connection_upgrade" variable
+```
+
+You may need to configure `$connection_upgrade` in your
+`/etc/nginx/nginx.conf`. See [this
+article](https://futurestud.io/tutorials/nginx-how-to-fix-unknown-connection_upgrade-variable)
+for more.
+
 ## Enable TCP ports
 
 For your room to fully work the following **TCP** ports need to be allowed:
diff --git a/docs/files/example-nginx.conf b/docs/files/example-nginx.conf
index eaf7843..8948590 100644
--- a/docs/files/example-nginx.conf
+++ b/docs/files/example-nginx.conf
@@ -21,6 +21,8 @@ server {
         # for websocket
         proxy_http_version 1.1;
         proxy_set_header Upgrade $http_upgrade;
+        # requires a $connection_upgrade definition in /etc/nginx/nginx.conf
+        # see https://futurestud.io/tutorials/nginx-how-to-fix-unknown-connection_upgrade-variable
         proxy_set_header Connection $connection_upgrade;
     }