Troubleshooting development setup
Common local problems.
| Problem | Check |
|---|---|
| Port already in use | Another process holds it. Find it with lsof -iTCP:<port> -sTCP:LISTEN. |
| Login always fails locally | The database may not contain your user. Register, then read the code from the backend log. |
| Frontend shows old UI | Rebuild the frontend image and recreate the container. |
Getting more detail
- Read service logs from the compose stack for errors.
- Open Flower for queue activity if background jobs seem stuck.
- Confirm your .env matches the ports and URLs your browser uses.