Install troubleshooting
In this page
pnpm / Node version
| Issue | Fix |
|---|---|
pnpm: command not found | corepack enable && corepack prepare pnpm@9.15.0 --activate |
| Engine errors | Use Node 20.11+ as required by monorepo package.json engines. |
Prisma / Postgres
| Issue | Fix |
|---|---|
P1001 connection errors | Verify DATABASE_URL host/port; for Docker use 127.0.0.1 if port published, or postgres from inside the API container. |
| Migration drift | Run pnpm --filter @deploydock/api exec prisma migrate deploy only on compatible schema versions. |
Redis and deploy queue
| Issue | Fix |
|---|---|
| Worker cannot connect | Match REDIS_HOST / REDIS_PORT to your Redis; set REDIS_PASSWORD on worker if needed. |
| Want to skip Redis | Set PANEL_DISABLE_QUEUE=1 on API — deploys will not execute worker adapters (see Environment variables). |
Docker build failures
| Issue | Fix |
|---|---|
apps/web/dist missing in prod nginx | Run pnpm --filter @deploydock/web build before docker compose -f deploy/docker/docker-compose.prod.yml up. |
| API cannot reach DB | Ensure depends_on services are healthy; check DATABASE_URL uses service name postgres inside the network. |