diff --git a/worker/Dockerfile b/worker/Dockerfile
index f491446..1967fbb 100644
--- a/worker/Dockerfile
+++ b/worker/Dockerfile
@@ -1,4 +1,6 @@
 ### Multi-stage build: compile TypeScript in a builder image, produce a smaller runtime image
+### IMPORTANT: Set Dokploy build path to "/" (repo root), NOT "worker/"
+### Dockerfile path should be "worker/Dockerfile"
 
 FROM node:20 AS builder
 WORKDIR /usr/src/app
diff --git a/worker/README.md b/worker/README.md
index b8021c1..7b624ce 100644
--- a/worker/README.md
+++ b/worker/README.md
@@ -3,8 +3,10 @@ Worker container and Dokploy settings
 
 Build context
 -------------
-- Build path: `worker/` (Dokploy should use this path so the worker Dockerfile is found)
-- Dockerfile: `worker/Dockerfile`
+- **Build path: `/` (repo root)** — NOT `worker/`!
+- **Dockerfile path: `worker/Dockerfile`**
+
+**IMPORTANT**: Dokploy must build from the repo root (`/`) so the Dockerfile can access `package.json`, `lib/`, and other files. If build path is set to `worker/`, the build will fail with "package.json: not found".
 
 Two-stage build (recommended)
 -----------------------------
@@ -16,7 +18,8 @@ Recommended Dokploy settings
 - Provider: `Gitea`
 - Repository: `ahmido/tenantpilot` (or your repo)
 - Branch: `development`
-- Build path: `worker/`
+- **Build path: `/`** (repo root)
+- **Dockerfile path: `worker/Dockerfile`**
 - Watch paths: `worker/**`, `lib/**`, `package.json`, `package-lock.json`
 
 Notes