Files
MediaManager/docs/troubleshooting.md
2026-01-07 19:10:20 +00:00

2.8 KiB

Troubleshooting

{% hint style="info" %} Always check the container and browser logs for more specific error messages {% endhint %}

Authentication Issues

I can't log in with OAuth/OIDC?

Verify provider configurationVerify your OAuth provider's configuration. See the OAuth documentationCheck callback URICheck if the callback URI you set in your OIDC providers settings is correct. See the callback URI documentationCheck frontend URLCheck the frontend url in your config file. It should match the URL you use to access MediaManager.

I cannot log in?

Confirm login vs signupMake sure you are logging in, not signing up.Try default credentialsTry logging in with the following credentials:Email: admin@mediamanager.local or admin@example.comPassword: 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?

Switch to advanced tabTry switching to the advanced tab when searching for torrents.Increase timeout for slow indexersIf you use "slow" indexers, try increasing the timeout threshold.Check logsIf 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:

{% hint style="info" %} If it still doesn't work, please open an Issue. It is possible that a bug is causing the issue. {% endhint %}