Fixed errors

README.md

@@ -106,6 +106,36 @@ codex login status
 ```
 Expected output includes: `Logged in using ChatGPT`.
 
+## Common first-run errors (and fixes)
+### Error: `permission denied while trying to connect to the Docker daemon socket`
+Cause: your Linux user is not allowed to use Docker yet.
+
+Fix:
+```bash
+sudo usermod -aG docker $USER
+newgrp docker
+docker compose up --build -d
+```
+If it still fails, log out and log back in, then retry.
+
+### Error during API image build: `Cannot find module /workspace/apps/api/scripts/copy-sql.mjs`
+Cause: older repo revision missing the script copy in `apps/api/Dockerfile`.
+
+Fix:
+```bash
+git pull
+docker compose build --no-cache api
+docker compose up -d
+```
+
+### `codex login` opens URL and then returns `Not logged in`
+Cause: login flow was interrupted (for example `Ctrl+C`) or not completed in browser.
+
+Fix:
+1. Run `codex login` and complete the browser flow fully.
+2. Verify with `codex login status`.
+3. Only use this if `LLM_PROVIDER=codex_oauth`. For `local_ollama`, Codex login is not required.
+
 ## Local Node runtime (optional, advanced)
 Use this if you do not want Docker:
 ```bash

apps/api/Dockerfile

@@ -5,6 +5,7 @@ COPY packages/contracts/package.json packages/contracts/tsconfig.json ./packages
 COPY packages/contracts/src ./packages/contracts/src
 COPY apps/api/package.json apps/api/tsconfig.json ./apps/api/
 COPY apps/api/src ./apps/api/src
+COPY apps/api/scripts ./apps/api/scripts
 RUN npm install
 RUN npm run -w @unfi/contracts build
 RUN npm run -w @unfi/api build

docker-compose.yml

@@ -1,5 +1,3 @@
-version: "3.9"
-
 services:
   postgres:
     image: postgres:16