--- a/host/doc/install.txt	Fri Jan 16 15:30:49 2026 -0800
+++ b/host/doc/install.txt	Fri Jan 16 15:59:00 2026 -0800
@@ -34,13 +34,18 @@
    nginx config can exist in many places, on old macOS it is usually /usr/local/etc/nginx/nginx.conf
    can also exist at /usr/local/nginx/conf/nginx.conf or /etc/nginx/nginx.conf
 
-   add this line inside the `http` block
+   add this line at the bottom of the `http` block, after `include servers/*` or `include conf.d/*` or similar
    include /Users/administrator/luan/host/local/nginx.conf;
 
    if nginx provides a default server, it conflicts with the luanhost one. remove or disable it.
    on old macOS this usually does not exist and this step is not needed
    sudo rm -r /etc/nginx/sites-enabled/default
 
+   if nginx has a server listening on 8080, it will conflict with luanhost
+   either remove it or tell it to listen on some other port
+   this command replaces 8080 with 8090 and creates a backup with .bak
+   sed -i.bak -E 's/listen[[:space:]]+8080/listen    8090/g' /usr/local/etc/nginx/nginx.conf
+
 9) open in browser http://me.luan.software:8080
 
 Install on production/test machine: