MediaManager/Writerside/topics/troubleshooting.md

Troubleshooting

Note the lack of a trailing slash in some env vars like FRONTEND_URL. This is important. Always check the container logs for more specific error messages

Authentication Issues

* Double-check `AUTH_TOKEN_SECRET`. If it changes, existing sessions/tokens will be invalidated.
* For OpenID:
    * Verify `OPENID_CLIENT_ID`, `OPENID_CLIENT_SECRET`, and `OPENID_CONFIGURATION_ENDPOINT` are correct.
    * Ensure the `FRONTEND_URL` is accurate and that your OpenID provider has the correct redirect URI whitelisted (
      e.g., `http://your-frontend-url/api/v1/auth/cookie/Authentik/callback`).
    * Check backend logs for errors from `httpx_oauth` or `fastapi-users`.

CORS Errors

* Ensure `FRONTEND_URL` is correctly set.
* Ensure your frontend's url is listed in `CORS_URLS`.

Data Not Appearing / File Issues

* Verify that the volume mounts for `IMAGE_DIRECTORY`, `TV_DIRECTORY`, `MOVIE_DIRECTORY`, and `TORRENT_DIRECTORY` in
  your `docker-compose.yml` are correctly pointing to your media folders on the host machine.
* Check file and directory permissions for the user running the Docker container (or the `node` user inside the
  containers).