Differences

This shows you the differences between two versions of the page.

--- installing_docassemble_docker_image_desktop_windows_11_pro [2026/07/27 22:31] – wikiadmin
+++ installing_docassemble_docker_image_desktop_windows_11_pro [2026/07/27 22:42] (current) – wikiadmin
@@ Line 73: / Line 73: @@
 Step 2: Configure Apache on your Ubuntu Server.
-On your Ubuntu server, Apache needs the proxy extensions enabled to capture incoming requests and pass them to the Windows machine.Log into your Ubuntu machine and enable the proxy modules:
+A.  On your Ubuntu server, Apache needs the proxy extensions enabled to capture incoming requests and pass them to the Windows machine.Log into your Ubuntu machine and enable the proxy modules:
 bash
@@ Line 80: / Line 80: @@
 sudo a2enmod proxy proxy_http proxy_wstunnel rewrite headers
 </code>
+B.  Create or modify an Apache Virtual Host configuration file (e.g., /etc/apache2/sites-available/docassemble-proxy.conf):
+Apache:
+<code>
+<VirtualHost *:80>
+    ServerName docassemble.yourdomain.local
+    ProxyRequests Off
+    ProxyPreserveHost On
+    # Forward standard HTTP traffic to Windows 11
+    ProxyPass / http://192.168.1.50
+    ProxyPassReverse / http://192.168.1.50
+    # Handle WebSocket connections (Critical for Docassemble's live interviews)
+    ProxyPass /wsws http://192.168.1wsws
+    ProxyPassReverse /wsws http://192.168.1wsws
+    # Security headers to ensure Docassemble maps links correctly
+    RequestHeader set X-Forwarded-Proto "http"
+    RequestHeader set X-Forwarded-Port "80"
+    ErrorLog ${APACHE_LOG_DIR}/docassemble_error.log
+    CustomLog ${APACHE_LOG_DIR}/docassemble_access.log combined
+</VirtualHost>
+</code>
+C.  Enable the configuration and restart Apache:
+bash
+<code>
+sudo a2ensite docassemble-proxy.conf
+sudo systemctl restart apache2
+</code>
+Step 3: Update Docassemble's Configuration
+Docassemble needs to know it is being accessed via a proxy domain so that it constructs external links, emails, and package management endpoints with the Ubuntu server's address instead of localhost.
+A.  Go to your web browser and open the configuration menu (once you can see it via the Ubuntu domain or the direct Windows IP).
+B.  Navigate to Configuration (System-wide configuration).
+C.  Add or update the following parameters:
+yaml
+<code>
+external hostname: docassemble.yourdomain.local
+behind https load balancer: false
+</code>
+(Note: If you eventually secure your Ubuntu Apache proxy using SSL/TLS Let's Encrypt certificates, change X-Forwarded-Proto to "https", change port to 443 in Step 2, and switch behind https load balancer to true).
+D.  Click Save and let the container restart its background services.
+Troubleshooting Windows Firewall Blockages
+By default, Windows 11 Firewall blocks unsolicited inbound traffic to ports even if Docker maps them. If your Ubuntu server gets a 502 Bad Gateway or Connection Timed Out when trying to contact the Windows IP:
+A.  Open Windows Defender Firewall with Advanced Security on your Windows 11 machine.
+B.  Click Inbound Rules -> New Rule.
+C.  Choose Port -> Select TCP -> Type 8080 into specific local ports.
+D.  Choose Allow the connection and apply it to your current network profile (Private domain recommended).
+Are you planning to configure SSL/HTTPS on the Ubuntu Apache box right away, or do you want to test the routing over plain HTTP first?