MediaManager Help

Troubleshooting

Authentication Issues

I can't log in with OAuth/OIDC?

  1. Verify your OAuth provider's configuration. See the OAuth documentation

  2. Check if the callback URI you set in your OIDC providers settings is correct. See the callback URI documentation

  3. Check the frontend url in your config file. It should match the URL you use to access MediaManager.

I cannot log in?

  1. Make sure you are logging in, not signing up.

  2. Try logging in with the following credentials:

    • Email: admin@mediamanager.local or admin@example.com

    • Password: admin

Hard linking Issues

The reason is that hard linking only works within the same filesystem. If your downloads are on a different volume than your media library, hard linking will not work.

Torrent Search Issues

I get no search results for torrents?

  1. Try switching to the advanced tab when searching for torrents.

  2. If you use "slow" indexers, try increasing the timeout threshold.

  3. If you still don't get any search results, check the logs, they will provide more information on what is going wrong.

Import and download Issues

Docker Image Pull Issues

  • If you get a 401 or 403 error when pulling the image from GHCR, this is not a permission issue with the repository/image. It errors because your Docker client is misconfigured.

  • This is not a MediaManager issue per se, so please don't open an issue about this on the MediaManager GitHub repo.

Possible Fixes:

05 January 2026