For anything not listed here, start with the container log: docker compose logs cookdex.
| Problem |
Fix |
| Weak master key warning |
Set a stronger MO_WEBUI_MASTER_KEY in .env, or let CookDex auto-generate one. See how secrets are stored. |
| 401 on login (cookie not sticking) |
Set WEB_COOKIE_SECURE=false in .env |
| Port already in use |
Set WEB_BIND_PORT=4821 in .env |
| Problem |
Fix |
Test Mealie fails with localhost |
Inside the CookDex container, localhost is the container itself. If CookDex and Mealie share a Docker network, use the Mealie service name, such as http://mealie:9000/api. See Getting started. |
| Direct DB can’t reach Mealie’s PostgreSQL |
If it is reachable only from the Docker host, connect over an SSH tunnel. See Direct DB access. |
| Problem |
Fix |
| Tasks page shows no tasks |
Ensure the server started without errors; check the container log with docker compose logs cookdex |
Confirm you can log in and check https://localhost:4820/cookdex/api/v1/health.
- The Help page inside CookDex documents every task and setting in place.
- Bugs and feature requests: open an issue.
