Set up Docker environment for local development and deployment

Configure Docker Compose, Dockerfiles for API and web servers, and a startup script to enable local development and deployment of the application.
2026-05-13 19:47:05 +00:00
parent 68a338f4cf
commit 7fcf516141
8 changed files with 403 additions and 185 deletions
@@ -1,56 +1,53 @@
-# Tx OS web — serves the built React/Vite SPA and reverse-proxies the
-# API + Socket.IO traffic to the api container on the private network.
 upstream tx_api {
-    server api:8080;
+  server api:8080;
 }

 server {
-    listen 80;
-    server_name _;
+  listen 80;
+  server_name _;
+
+  client_max_body_size 50m;
+
+  # WebSocket / Socket.IO upgrade for /api/socket.io
+  location /api/socket.io/ {
+    proxy_pass http://tx_api;
+    proxy_http_version 1.1;
+    proxy_set_header Upgrade $http_upgrade;
+    proxy_set_header Connection "upgrade";
+    proxy_set_header Host $host;
+    proxy_set_header X-Real-IP $remote_addr;
+    proxy_set_header X-Forwarded-For $proxy_add_x_forwarded_for;
+    proxy_set_header X-Forwarded-Proto $scheme;
+    proxy_read_timeout 3600s;
+    proxy_send_timeout 3600s;
+  }
+
+  # Forward all /api requests to the Node API server
+  location /api/ {
+    proxy_pass http://tx_api;
+    proxy_http_version 1.1;
+    proxy_set_header Host $host;
+    proxy_set_header X-Real-IP $remote_addr;
+    proxy_set_header X-Forwarded-For $proxy_add_x_forwarded_for;
+    proxy_set_header X-Forwarded-Proto $scheme;
+    proxy_read_timeout 300s;
+    proxy_send_timeout 300s;
+  }
+
+  # Static SPA assets with hashed filenames — cache aggressively
+  location /assets/ {
+    root /usr/share/nginx/html;
+    expires 1y;
+    access_log off;
+    add_header Cache-Control "public, immutable";
+    try_files $uri =404;
+  }
+
+  # SPA fallback — every unknown path returns index.html
+  location / {
    root /usr/share/nginx/html;
    index index.html;
-
-    # Health endpoint for compose / load balancer probes.
-    location = /healthz {
-        access_log off;
-        return 200 "ok\n";
-        add_header Content-Type text/plain;
-    }
-
-    # Socket.IO upgrade — must come before the generic /api/ block so the
-    # WebSocket handshake gets the upgrade headers it needs.
-    location /api/socket.io/ {
-        proxy_pass http://tx_api;
-        proxy_http_version 1.1;
-        proxy_set_header Upgrade $http_upgrade;
-        proxy_set_header Connection "upgrade";
-        proxy_set_header Host $host;
-        proxy_set_header X-Real-IP $remote_addr;
-        proxy_set_header X-Forwarded-For $proxy_add_x_forwarded_for;
-        proxy_set_header X-Forwarded-Proto $scheme;
-        proxy_read_timeout 1h;
-    }
-
-    # All other API calls.
-    location /api/ {
-        proxy_pass http://tx_api;
-        proxy_http_version 1.1;
-        proxy_set_header Host $host;
-        proxy_set_header X-Real-IP $remote_addr;
-        proxy_set_header X-Forwarded-For $proxy_add_x_forwarded_for;
-        proxy_set_header X-Forwarded-Proto $scheme;
-        client_max_body_size 25m;
-    }
-
-    # SPA: serve hashed assets with long-cache; fall back to index.html.
-    location ~* \.(?:js|css|woff2?|png|jpg|jpeg|gif|svg|ico|webp|map)$ {
-        expires 30d;
-        add_header Cache-Control "public, immutable";
-        try_files $uri =404;
-    }
-
-    location / {
-        try_files $uri $uri/ /index.html;
-        add_header Cache-Control "no-cache";
-    }
+    try_files $uri $uri/ /index.html;
+    add_header Cache-Control "no-cache";
+  }
 }