From b422f2af3a8c4a66b6897dc6697046c2c0e5a9a1 Mon Sep 17 00:00:00 2001
From: Kiow <justme@kiow.ru>
Date: Sun, 14 Jun 2026 01:39:15 +0300
Subject: [PATCH] v30.3

---
 README.md               | 31 +++++++++++++++++++++++++++++--
 docker-compose.base.yml | 31 +++++++++++++++++++++++++++++--
 panel.md                |  1 +
 3 files changed, 59 insertions(+), 4 deletions(-)

diff --git a/README.md b/README.md
index 74eca60..747e0f6 100644
--- a/README.md
+++ b/README.md
@@ -41,12 +41,35 @@ Create a `docker-compose.yml` from the base example:
 version: '3.9'
 
 services:
+  postgres:
+    image: postgres:16-alpine
+    container_name: nexuma-postgres
+    restart: unless-stopped
+    environment:
+      POSTGRES_USER: postgres
+      POSTGRES_PASSWORD: change-me
+      POSTGRES_DB: nexuma
+    volumes:
+      - postgres_data:/var/lib/postgresql/data
+    healthcheck:
+      test: ["CMD-SHELL", "pg_isready -U postgres"]
+      interval: 10s
+      timeout: 5s
+      retries: 5
+    networks:
+      - nexuma
+
   redis:
     image: redis:7-alpine
     container_name: nexuma-redis
     restart: unless-stopped
     volumes:
       - redis_data:/data
+    healthcheck:
+      test: ["CMD", "redis-cli", "ping"]
+      interval: 10s
+      timeout: 5s
+      retries: 5
     networks:
       - nexuma
 
@@ -57,7 +80,7 @@ services:
     environment:
       PORT: 3000
       GRPC_PORT: 3002
-      DB_HOST: your-postgres-host
+      DB_HOST: postgres
       DB_PORT: 5432
       DB_USER: postgres
       DB_PASSWORD: change-me
@@ -73,7 +96,10 @@ services:
       - "3000:3000"
       - "3002:3002"
     depends_on:
-      - redis
+      postgres:
+        condition: service_healthy
+      redis:
+        condition: service_healthy
     networks:
       - nexuma
 
@@ -92,6 +118,7 @@ services:
       - nexuma
 
 volumes:
+  postgres_data:
   redis_data:
 
 networks:
diff --git a/docker-compose.base.yml b/docker-compose.base.yml
index 46c9172..a7fdf34 100644
--- a/docker-compose.base.yml
+++ b/docker-compose.base.yml
@@ -4,12 +4,35 @@ version: '3.9'
 # Usage: docker compose -f docker-compose.base.yml up -d
 
 services:
+  postgres:
+    image: postgres:16-alpine
+    container_name: nexuma-postgres
+    restart: unless-stopped
+    environment:
+      POSTGRES_USER: postgres
+      POSTGRES_PASSWORD: change-me
+      POSTGRES_DB: nexuma
+    volumes:
+      - postgres_data:/var/lib/postgresql/data
+    healthcheck:
+      test: ["CMD-SHELL", "pg_isready -U postgres"]
+      interval: 10s
+      timeout: 5s
+      retries: 5
+    networks:
+      - nexuma
+
   redis:
     image: redis:7-alpine
     container_name: nexuma-redis
     restart: unless-stopped
     volumes:
       - redis_data:/data
+    healthcheck:
+      test: ["CMD", "redis-cli", "ping"]
+      interval: 10s
+      timeout: 5s
+      retries: 5
     networks:
       - nexuma
 
@@ -20,7 +43,7 @@ services:
     environment:
       PORT: 3000
       GRPC_PORT: 3002
-      DB_HOST: your-postgres-host
+      DB_HOST: postgres
       DB_PORT: 5432
       DB_USER: postgres
       DB_PASSWORD: change-me
@@ -37,7 +60,10 @@ services:
       - "3000:3000"
       - "3002:3002"
     depends_on:
-      - redis
+      postgres:
+        condition: service_healthy
+      redis:
+        condition: service_healthy
     networks:
       - nexuma
     healthcheck:
@@ -62,6 +88,7 @@ services:
       - nexuma
 
 volumes:
+  postgres_data:
   redis_data:
 
 networks:
diff --git a/panel.md b/panel.md
index 58b9800..c1aac98 100644
--- a/panel.md
+++ b/panel.md
@@ -135,6 +135,7 @@ This page is public operator documentation. It describes panel capabilities, rou
 | --- | --- | --- | --- |
 | `NUXT_PUBLIC_API_BASE` | No | `/api` | Browser-facing API base. Use `/api` for same-origin panel proxying. |
 | `NUXT_CORE_URL` | Yes for Docker | `http://localhost:3000` fallback | Core URL used by the panel server proxy. |
+| `NUXT_PUBLIC_WS_BASE` | No | empty (same origin) | WebSocket origin for the Socket.IO client (`/ws`). Empty = same origin (prod behind a reverse proxy that forwards `/ws` to Core); in dev point at Core, e.g. `http://localhost:3000`. |
 
 Recommended production values: