MediaManager Help

Troubleshooting

Authentication Issues (OIDC)

  • 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.yaml 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).

01 June 2025