Merge branch 'cameri:main' into fix/dns-preflight-check

Author: YashIIT0909

README.md

@@ -210,6 +210,16 @@ Start:
   ./scripts/start_with_tor
   ```
 
+**Windows / WSL2 users:** Docker bind-mounts can cause PostgreSQL permission errors on Windows. Use the dedicated override file instead:
+  ```
+  docker compose -f docker-compose.yml -f docker-compose.windows.yml up --build
+  ```
+  Or add this to your `.env` file so you don't have to type it every time:
+  ```
+  COMPOSE_FILE=docker-compose.yml:docker-compose.windows.yml
+  ```
+  > **Note:** If you previously ran Nostream on Linux/Mac and are switching to Windows, your existing data lives at `.nostr/data/` on the host. You'll need to copy it into the Docker named volume manually or it won't be visible to the new setup.
+
 Stop the server with:
   ```
   ./scripts/stop
@@ -263,6 +273,60 @@ The logs can be viewed with:
   journalctl -u nostream
   ```
 
+## Troubleshooting
+
+### Linux: Docker DNS resolution failures (`EAI_AGAIN`)
+
+On some Linux environments (especially rolling-release distros or setups using
+`systemd-resolved`), `docker compose` builds can fail with DNS errors such as:
+
+- `getaddrinfo EAI_AGAIN registry.npmjs.org`
+- `Temporary failure in name resolution`
+
+To fix this, configure Docker daemon DNS in `/etc/docker/daemon.json`.
+
+1. Create or update `/etc/docker/daemon.json`:
+
+  ```
+  sudo mkdir -p /etc/docker
+  sudo nano /etc/docker/daemon.json
+  ```
+
+  Add or update the file with:
+
+  ```
+  {
+    "dns": ["1.1.1.1", "8.8.8.8"]
+  }
+  ```
+
+  If this file already exists, merge the `dns` key into the existing JSON
+  instead of replacing the entire file.
+
+  If your environment does not allow public resolvers, replace `1.1.1.1` and
+  `8.8.8.8` with DNS servers approved by your network.
+
+2. Restart Docker:
+
+  ```
+  sudo systemctl restart docker
+  ```
+
+3. Verify DNS works inside containers:
+
+  ```
+  docker run --rm busybox nslookup registry.npmjs.org
+  ```
+
+4. Retry starting nostream:
+
+  ```
+  ./scripts/start
+  ```
+
+Note: avoid `127.0.0.53` in Docker DNS settings because it points to the host's
+local resolver stub and is often unreachable from containers.
+
 ## Quick Start (Standalone)
 
 Set the following environment variables:
@@ -372,7 +436,7 @@ Clone repository and enter directory:
 
 Start:
   ```
-  ./scripts/start_local
+  ./scripts/start
   ```
 
   This will run in the foreground of the terminal until you stop it with Ctrl+C.

docker-compose.windows.yml

@@ -0,0 +1,28 @@
+# docker-compose.windows.yml
+#
+# Windows / WSL2 override for Nostream.
+#
+# On Windows (including WSL2), Docker bind-mounts to host paths can cause
+# PostgreSQL permission errors. This override replaces the bind-mount for
+# PostgreSQL data with a named Docker volume, which is managed entirely
+# by the Docker engine and avoids those issues.
+#
+# Usage:
+#   docker compose -f docker-compose.yml -f docker-compose.windows.yml up --build
+#
+# Or set COMPOSE_FILE in your .env:
+#   COMPOSE_FILE=docker-compose.yml:docker-compose.windows.yml
+#
+# WARNING: If you previously ran Nostream with the default docker-compose.yml
+# your data is in .nostr/data/ on the host. Before switching to this file,
+# migrate your data or it will not be accessible from the named volume.
+
+services:
+  nostream-db:
+    volumes:
+      - nostream-db-data:/var/lib/postgresql/data
+      - ${PWD}/.nostr/db-logs:/var/log/postgresql
+      - ${PWD}/postgresql.conf:/postgresql.conf
+
+volumes:
+  nostream-db-data: