mirror of https://github.com/maxdorninger/MediaManager.git synced 2026-04-17 19:53:55 +02:00

Files

Maximilian Dorninger 1b2d99922c Switch to quay and add docker image documentation (#356 )

This PR changes all mentions of GHCR to Quay, adds docs about the
registries MM is available on, adds docs about the available docker
image tags, and adds the GHCR permission issue to the troubleshooting
page.

2026-01-05 17:14:32 +01:00

2.9 KiB

Raw Blame History

Troubleshooting

Always check the container and browser logs for more specific error messages

Authentication Issues

Verify your OAuth provider's configuration. See the OAuth documentation Check if the callback URI you set in your OIDC providers settings is correct. See the callback URI documentation Check the frontend url in your config file. It should match the URL you use to access MediaManager. Make sure you are logging in, not signing up. Try logging in with the following credentials:

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

Password: admin

Hard linking Issues

Make sure you are using only one volumes for TV, Movies and Downloads. See the configuration in the example docker-compose.yaml file.

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

Try switching to the advanced tab when searching for torrents. If you use "slow" indexers, try increasing the timeout threshold. 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

If you configured a category with a special save path, carefully read this page about MM with qBittorrent save paths.

If it still doesn't work, please open an Issue. It is possible that a bug is causing the issue.

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.

2.9 KiB Raw Blame History